TECHNICAL ISO/IEC TS SPECIFICATION 19216 First edition 2018-04 Programming Languages C++ Extensions for Networking Langages de programmation-Extensions C++ pour mise en réseau Reference number IEC IS0/IEC TS 19216:2018(E) s @IS0/IEC 2018 IS0/IEC TS 19216:2018(E) COPYRIGHTPROTECTEDDOCUMENT @ IS0/IEC 2018 All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting on the internet or an intranet, without prior written permission. Permission can be requested from either IsO at the address below or Iso's member body in the country of the requester. ISO copyright office CP 401 : Ch. de Blandonnet 8 CH-1214 Vernier, Geneva Phone: +4122 749 0111 Fax: +41 22 749 09 47 Email: [email protected] Website: www.iso.org Published in Switzerland ii @ IS0/IEC 2018 - All rights reserved ISO/IEC TS 19216:2018(E) Contents Foreword vi 1 Scope 1 2 Normative references 2 3 Terms and definitions 3 4 General Principles 4 4.1 Conformance 4.2 Acknowledgments 5 Namespaces and headers 6 Future plans (Informative) 6 7 Feature test macros (Informative) 7 8 Method of description (Informative) 8 8.1 Structure of each clause 8 8.2 Other conventions 8 9 Error reporting 6 9.1 Synchronous operations 9 9.2 Asynchronous operations 10 9.3 Error conditions 10 9.4 Suppression of signals 10 10 Library summary 11 11 Convenience header 13 11.1 Header <experimental/net> synopsis 13 12 Forward declarations 14 12.1 Header <experimental/netfwd> synopsis 14 13 Asynchronous model 16 13.1 Header <experimental/executor> synopsis 16 13.2 Requirements 19 13.3 Class template async_result 27 13.4 Class template async_completion 28 13.5 Class template associated_allocator 29 13.6 Function get_associated_allocator 30 13.7 Class execution_context 30 13.8 Class execution_context: :service 32 13.9 Class template is_executor 33 13.10 Executor argument tag 33 13.11 uses_executor 34 @ISO/IEC 2018 - All rights reserved ii ISO/IEC TS 19216:2018(E) 13.12 Class template associated_executor 34 13.13 Function get_associated_executor 35 13.14 Class template executor_binder 36 13.15 Function bind_executor. 39 13.16 Class template executor_work_guard 40 13.17 Function make_work_guard 41 13.18 Class system_executor 42 13.19 Class system_context 43 13.20 Class bad_executor 44 13.21 Class executor 45 13.22 Function dispatch 49 . . · 13.23 Function post 50 13.24 Function defer 51 13.25 Class template strand 52 13.26 Class template use_future_t 56 13.27 Partial specialization of async_result for packaged_task 59 14 Basic I/0 services 61 14.1 Header <experimental/io_context> synopsis 61 14.2 Class io_context 61 14.3 Class io_context: :executor_type 65 15 Timers 67 15.1 Header <experimental/timer> synopsis 67 15.2 Requirements 67 15.3 Class template wait_traits 68 15.4 Class template basic_waitable_timer 69 16 Buffers 73 16.1 Header <experimental/buffer> synopsis 73 16.2 Requirements 78 16.3 Error codes 82 16.4 Class mutable_buffer 82 16.5 Class const_buffer 83 16.6 Buffer type traits 84 16.7 Buffer sequence access 85 16.8 Function buffer_size 85 16.9 Function buffer_copy 85 16.10 Buffer arithmetic 86 16.11 Buffer creation functions 86 16.12 Class template dynamic_vector_buffer 88 16.13 Class template dynamic_string_buffer 89 16.14 Dynamic buffer creation functions . 91 17 Buffer-oriented streams 92 17.1 Requirements 92 17.2 Class transfer_all 94 17.3 Class transfer_at_least 95 17.4 Class transfer_exactly 95 17.5 Synchronous read operations 96 17.6 Asynchronous read operations 98 @ISO/IEC 2018 - All rights reserved iv ISO/IEC TS 19216:2018(E) 17.7 Synchronous write operations 66 17.8 Asynchronous write operations 100 17.9 Synchronous delimited read operations 102 17.10 Asynchronous delimited read operations 102 18 Sockets 104 18.1 Header <experimental/socket> synopsis 104 18.2 Requirements 106 18.3 Erro