<li>The blocksize given is only advisory and to be seen as an upper limit,
if an underlying read returns less bytes the chunk is nevertheless returned.
- <li>If the limit parameter is ommited, the iterator returns data
+ <li>If the limit parameter is omitted, the iterator returns data
until an end-of-file, end-of-stream, connection shutdown or similar happens.
<li>The iterator will not buffer so it is safe to mix with calls to read.
<li>This function uses the blocksource function of the source descriptor
and the sink function of the target descriptor.
- <li>If the limit parameter is ommited, data is copied
+ <li>If the limit parameter is omitted, data is copied
until an end-of-file, end-of-stream, connection shutdown or similar happens.
<li>If the descriptor is non-blocking the function may fail with EAGAIN.
<h3>Return values:</h3>
<ol>
- <li>bytes that were successfully written if no error occured
+ <li>bytes that were successfully written if no error occurred
<li>- reserved for error code -
<li>- reserved for error message -
- <li>bytes that were successfully written even if an error occured
+ <li>bytes that were successfully written even if an error occurred
</ol>
blocksource function of the source descriptor and the sink function
of the target descriptor as a fallback mechanism.
- <li>If the limit parameter is ommited, data is copied
+ <li>If the limit parameter is omitted, data is copied
until an end-of-file, end-of-stream, connection shutdown or similar happens.
<li>If the descriptor is non-blocking the function may fail with EAGAIN.
<h3>Return values:</h3>
<ol>
- <li>bytes that were successfully written if no error occured
+ <li>bytes that were successfully written if no error occurred
<li>- reserved for error code -
<li>- reserved for error message -
- <li>bytes that were successfully written even if an error occured
+ <li>bytes that were successfully written even if an error occurred
</ol>
you can pass "true" to the iterator which will flush the buffer
and return the bufferd data.
- <li>If the limit parameter is ommited, this function uses the nixio
+ <li>If the limit parameter is omitted, this function uses the nixio
buffersize (8192B by default).
<li>If the descriptor is non-blocking the iterator may fail with EAGAIN.
<li>This function uses the low-level read function of the descriptor.
- <li>If the length parameter is ommited, this function returns all data
+ <li>If the length parameter is omitted, this function returns all data
that can be read before an end-of-file, end-of-stream, connection shutdown
or similar happens.
<h3>Return values:</h3>
<ol>
- <li>data that was successfully read if no error occured
+ <li>data that was successfully read if no error occurred
<li>- reserved for error code -
<li>- reserved for error message -
- <li>data that was successfully read even if an error occured
+ <li>data that was successfully read even if an error occurred
</ol>
<h3>Return values:</h3>
<ol>
- <li>bytes that were successfully written if no error occured
+ <li>bytes that were successfully written if no error occurred
<li>- reserved for error code -
<li>- reserved for error message -
- <li>bytes that were successfully written even if an error occured
+ <li>bytes that were successfully written even if an error occurred
</ol>