In the table below,
an asynchronous read stream object,
denotes an object satisfying mutable
buffer sequence requirements, and
denotes an object satisfying read
Table 3. Buffer-oriented asynchronous read stream requirements
object through which the
h will be invoked.
Initiates an asynchronous operation to read one or more bytes of data
from the stream
The operation is performed via the
and behaves according to asynchronous
The mutable buffer sequence
mb specifies memory
where the data should be placed. The
operation shall always fill a buffer in the sequence completely before
proceeding to the next.
The implementation shall maintain
one or more copies of
until such time as the read operation no longer requires access to
the memory specified by the buffers in the sequence. The program must
ensure the memory is valid until:
— the last copy of
mb is destroyed, or
— the handler for the asynchronous read operation is invoked,
whichever comes first.
If the total size of all
buffers in the sequence
0, the asynchronous
read operation shall complete immediately and pass
as the argument to the handler that specifies the number of bytes read.