Skip to content

Commit 3e70dd9

Browse files
committed
Correct ambiguous workding in read-some-rationale.md
1 parent 43bbbe6 commit 3e70dd9

File tree

1 file changed

+16
-14
lines changed

1 file changed

+16
-14
lines changed

doc/read-some-rationale.md

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)