diff options
Diffstat (limited to '3rdparty/asio/src/doc/requirements/SyncWriteStream.qbk')
-rw-r--r-- | 3rdparty/asio/src/doc/requirements/SyncWriteStream.qbk | 39 |
1 files changed, 39 insertions, 0 deletions
diff --git a/3rdparty/asio/src/doc/requirements/SyncWriteStream.qbk b/3rdparty/asio/src/doc/requirements/SyncWriteStream.qbk new file mode 100644 index 00000000000..713050c7552 --- /dev/null +++ b/3rdparty/asio/src/doc/requirements/SyncWriteStream.qbk @@ -0,0 +1,39 @@ +[/ + / Copyright (c) 2003-2016 Christopher M. Kohlhoff (chris at kohlhoff dot com) + / + / Distributed under the Boost Software License, Version 1.0. (See accompanying + / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) + /] + +[section:SyncWriteStream Buffer-oriented synchronous write stream requirements] + +A type `X` meets the `SyncWriteStream` requirements if it satisfies the +requirements listed below. + +In the table below, `a` denotes a value of type `X`, `cb` denotes a (possibly +const) value satisfying the [link asio.reference.ConstBufferSequence +`ConstBufferSequence`] requirements, and `ec` denotes an object of type +`error_code`. + +[table SyncWriteStream requirements + [[operation] [type] [semantics, pre/post-conditions]] + [ + [`a.write_some(cb)`\n + `a.write_some(cb,ec)`] + [`size_t`] + [ + Meets the requirements for a [link asio.reference.read_write_operations + write operation].\n + \n + If `buffer_size(cb) > 0`, writes one or more bytes of data to the stream + `a` from the buffer sequence `cb`. If successful, sets `ec` such that + `!ec` is `true`, and returns the number of bytes written. If an error + occurred, sets `ec` such that `!!ec` is `true`, and returns 0.\n + \n + If `buffer_size(cb) == 0`, the operation shall not block. Sets `ec` such + that `!ec` is `true`, and returns 0. + ] + ] +] + +[endsect] |