@@ -23,15 +23,15 @@ concepts with the following contracts:
2323
2424 Semantic Requirements:
2525
26- If buffer_size( buffers ) > 0, the operation reads zero or
27- more bytes from the stream into the buffer sequence:
26+ Attempts to read up to buffer_size( buffers ) bytes from
27+ the stream into the buffer sequence.
2828
29- - On success: !ec, and n is the number of bytes read
30- (at least 1).
31- - On error: ec, and n is the number of bytes read before
32- the error (may be 0) .
33- - On end-of-file: ec == cond::eof, and n is the number of
34- bytes read before EOF (may be 0) .
29+ If buffer_size( buffers ) > 0:
30+
31+ - If ! ec, then 1 <= n <= buffer_size( buffers ). n bytes
32+ were read into the buffer sequence .
33+ - If ec, then 0 <= n <= buffer_size( buffers ). n is the
34+ number of bytes read before the I/O condition arose .
3535
3636 If buffer_empty( buffers ) is true, n is 0. The empty buffer
3737 is not itself a cause for error, but ec may reflect the state
@@ -59,13 +59,15 @@ concept ReadStream =
5959
6060 Semantic Requirements:
6161
62- If buffer_size( buffers ) > 0, the operation writes zero or
63- more bytes from the buffer sequence to the stream:
62+ Attempts to write up to buffer_size( buffers ) bytes from
63+ the buffer sequence to the stream.
64+
65+ If buffer_size( buffers ) > 0:
6466
65- - On success: !ec, and n is the number of bytes written
66- (at least 1) .
67- - On error: ec, and n is the number of bytes written before
68- the error (may be 0) .
67+ - If !ec, then 1 <= n <= buffer_size( buffers ). n bytes
68+ were written from the buffer sequence .
69+ - If ec, then 0 <= n <= buffer_size( buffers ). n is the
70+ number of bytes written before the I/O condition arose .
6971
7072 If buffer_empty( buffers ) is true, n is 0. The empty buffer
7173 is not itself a cause for error, but ec may reflect the state
0 commit comments