...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
In the table below, a
denotes
a synchronous random-access read device object, o
denotes an offset of type boost::uint64_t
,
mb
denotes an object satisfying
mutable buffer
sequence requirements, and ec
denotes an object of type error_code
.
Table 34. Buffer-oriented synchronous random-access read device requirements
operation |
type |
semantics, pre/post-conditions |
---|---|---|
|
|
Equivalent to: error_code ec; size_t s = a.read_some_at(o, mb, ec); if (ec) throw system_error(ec); return s;
|
|
|
Reads one or more bytes of data from the device |