autodoc.git / traditional_manual / chapter_9.html

version» Context lines:

autodoc.git/traditional_manual/chapter_9.html:1113:   <p> If something goes wrong and <code>not_all</code> is set, zero is returned.    If something goes wrong and <code>not_all</code> is zero or left out, then    either zero or a string shorter than <code>len</code> is returned. If the    problem persists then a later call to <code>read()</code> fails and returns    zero, however.</p>   <p> If everything went fine, a call to <code>errno()</code> directly afterwards    returns zero. That includes an end due to end-of-file or remote    close.</p>   <p> If no arguments are given, <code>read()</code> reads to the end of the file    or stream.</p> + <p> If any file descriptors have been sent by the other side of the +  stream, <code>receive_fd()</code> will be called once for every sent file +  descriptor.</p>   </dd>   <dt class='head--doc'>Note</dt>   <dd class='body--doc'><p>It's not necessary to set <code>not_all</code> to avoid blocking reading    when nonblocking mode is used.</p>   </dd>   <dt class='head--doc'>Note</dt>   <dd class='body--doc'><p>When at the end of a file or stream, repeated calls to <code>read()</code> -  returns the empty string since it's not considered an error. The -  empty string is never returned in other cases, unless nonblocking +  will return the empty string since it's not considered an error. +  The empty string is never returned in other cases, unless nonblocking    mode is used or <code>len</code> is zero.</p>   </dd>   <dt class='head--doc'>See also</dt> - <dd class='body--doc'><p><code>read_oob()</code>, <code>write()</code></p> + <dd class='body--doc'><p><code>read_oob()</code>, <code>write()</code>, <code>receive_fd()</code>, <code>send_fd()</code></p>   </dd></dl>         <hr />   <dl class='group--doc'>   <dt class='head--type'><span class='homogen--type'>Method</span>   <span class='homogen--name'><b>read_function</b></span>   </dt>   <dd><p><code><code class='datatype'>function</code>(:<code class='datatype'>string</code>) <b><span class='method'>read_function</span>(</b><code class='datatype'>int</code> <code class='argument'>nbytes</code><b>)</b></code></p></dd>