diff options
Diffstat (limited to '3rdparty/asio/src/doc/requirements/SyncRandomAccessWriteDevice.qbk')
-rw-r--r-- | 3rdparty/asio/src/doc/requirements/SyncRandomAccessWriteDevice.qbk | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/3rdparty/asio/src/doc/requirements/SyncRandomAccessWriteDevice.qbk b/3rdparty/asio/src/doc/requirements/SyncRandomAccessWriteDevice.qbk new file mode 100644 index 00000000000..c7a2686f17b --- /dev/null +++ b/3rdparty/asio/src/doc/requirements/SyncRandomAccessWriteDevice.qbk @@ -0,0 +1,49 @@ +[/ + / 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:SyncRandomAccessWriteDevice Buffer-oriented synchronous random-access +write device requirements] + +In the table below, `a` denotes a synchronous random-access write device +object, `o` denotes an offset of type `boost::uint64_t`, `cb` denotes an object +satisfying [link asio.reference.ConstBufferSequence constant buffer sequence] +requirements, and `ec` denotes an object of type `error_code`. + +[table Buffer-oriented synchronous random-access write device requirements + [[operation] [type] [semantics, pre/post-conditions]] + [ + [`a.write_some_at(o, cb);`] + [`size_t`] + [Equivalent to: + `` + error_code ec; + size_t s = a.write_some(o, cb, ec); + if (ec) throw system_error(ec); + return s; + ``] + ] + [ + [`a.write_some_at(o, cb, ec);`] + [`size_t`] + [ + Writes one or more bytes of data to the device `a` at offset `o`.\n + \n + The constant buffer sequence `cb` specifies memory where the data to be + written is located. The `write_some_at` operation shall always write a + buffer in the sequence completely before proceeding to the next.\n + \n + If successful, returns the number of bytes written and sets `ec` such + that `!ec` is true. If an error occurred, returns `0` and sets `ec` such + that `!!ec` is true.\n + \n + If the total size of all buffers in the sequence `cb` is `0`, the + function shall return `0` immediately. + ] + ] +] + +[endsect] |