ansistdio.html

Vxworks API操作系统和驱动程序设计API。压缩的HTML文件

written to the file; any unread buffered data is discarded.  The stream
is disassociated from the file.  If the associated buffer was allocated
automatically, it is deallocated.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
Zero if the stream is closed successfully, or EOF if errors occur.
<p>
</blockquote><h4>ERRNO</h4><blockquote><p>
EBADF
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiStdio.html#top">ansiStdio</a></b>, <b><a href="./ansiStdio.html#fflush">fflush</a>(&nbsp;)</b>

<hr>
<a name="fdopen"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>fdopen(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>fdopen(&nbsp;)</strong> - open a file specified by a file descriptor (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>FILE * fdopen
    (
    int          fd,          /* file descriptor */
    const char * mode         /* mode to open with */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine opens the file specified by the file descriptor <i>fd</i> and
associates a stream with it.
The <i>mode</i> argument is used just as in the <b><a href="./ansiStdio.html#fopen">fopen</a>(&nbsp;)</b> function.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
A pointer to a stream, or a null pointer if an error occurs,
with <b>errno</b> set to indicate the error.
<p>
</blockquote><h4>ERRNO</h4><blockquote><p>
EINVAL
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiStdio.html#top">ansiStdio</a></b>, <b><a href="./ansiStdio.html#fopen">fopen</a>(&nbsp;)</b>, <b><a href="./ansiStdio.html#freopen">freopen</a>(&nbsp;)</b>,  
* .I "Information Technology - POSIX - Part 1:"
<i>System API [C Language], IEEE Std 1003.1</i>

<hr>
<a name="feof"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>feof(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>feof(&nbsp;)</strong> - test the end-of-file indicator for a stream (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int feof
    (
    FILE * fp                 /* stream to test */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine tests the end-of-file indicator for a specified stream. 
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
Non-zero if the end-of-file indicator is set for <i>fp</i>.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiStdio.html#top">ansiStdio</a></b>, <b><a href="./ansiStdio.html#clearerr">clearerr</a>(&nbsp;)</b>

<hr>
<a name="ferror"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>ferror(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>ferror(&nbsp;)</strong> - test the error indicator for a file pointer (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int ferror
    (
    FILE * fp                 /* stream to test */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine tests the error indicator for the stream pointed to by <i>fp</i>.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
Non-zero if the error indicator is set for <i>fp</i>.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiStdio.html#top">ansiStdio</a></b>, <b><a href="./ansiStdio.html#clearerr">clearerr</a>(&nbsp;)</b>

<hr>
<a name="fflush"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>fflush(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>fflush(&nbsp;)</strong> - flush a stream (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int fflush
    (
    FILE * fp                 /* stream to flush */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine writes to the file any unwritten data for a specified output
or update stream for which the most recent operation was not input; for an
input stream the behavior is undefined.
<p>
</blockquote><h4>CAVEAT</h4><blockquote><p>
ANSI specifies that if <i>fp</i> is a null pointer, <b><a href="./ansiStdio.html#fflush">fflush</a>(&nbsp;)</b> performs the
flushing action on all streams for which the behavior is defined; however,
this is not implemented in VxWorks.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
Zero, or EOF if a write error occurs.
<p>
</blockquote><h4>ERRNO</h4><blockquote><p>
EBADF
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiStdio.html#top">ansiStdio</a></b>, <b><a href="./ansiStdio.html#fclose">fclose</a>(&nbsp;)</b>

<hr>
<a name="fgetc"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>fgetc(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>fgetc(&nbsp;)</strong> - return the next character from a stream (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int fgetc
    (
    FILE * fp                 /* stream to read from */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the next character (converted to an <b>int</b>) from the
specified stream, and advances the file position indicator for the stream.
<p>
If the stream is at end-of-file, the end-of-file indicator for the stream is
set; if a read error occurs, the error indicator is set.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
The next character from the stream, or EOF if the stream is at end-of-file
or a read error occurs.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiStdio.html#top">ansiStdio</a></b>, <b><a href="./ansiStdio.html#fgets">fgets</a>(&nbsp;)</b>, <b><a href="./ansiStdio.html#getc">getc</a>(&nbsp;)</b>

<hr>
<a name="fgetpos"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>fgetpos(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>fgetpos(&nbsp;)</strong> - store the current value of the file position indicator for a stream (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int fgetpos
    (
    FILE *   fp,              /* stream */
    fpos_t * pos              /* where to store position */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine stores the current value of the file position indicator for a
specified stream <i>fp</i> in the object pointed to by <i>pos</i>.  The value stored
contains unspecified information usable by <b><a href="./ansiStdio.html#fsetpos">fsetpos</a>(&nbsp;)</b> for repositioning
the stream to its position at the time <b><a href="./ansiStdio.html#fgetpos">fgetpos</a>(&nbsp;)</b> was called.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
Zero, or non-zero if unsuccessful, with <b>errno</b> set to indicate the error.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiStdio.html#top">ansiStdio</a></b>, <b><a href="./ansiStdio.html#fsetpos">fsetpos</a>(&nbsp;)</b>

<hr>
<a name="fgets"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>fgets(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>fgets(&nbsp;)</strong> - read a specified number of characters from a stream (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>char * fgets
    (
    char * buf,               /* where to store characters */
    size_t n,                 /* no. of bytes to read + 1 */
    FILE * fp                 /* stream to read from */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine stores in the array <i>buf</i> up to <i>n</i>-1 characters from a
specified stream.  No additional characters are read after a new-line or
end-of-line.  A null character is written immediately after the last
character read into the array.
<p>
If end-of-file is encountered and no characters have been read, the
contents of the array remain unchanged.  If a read error occurs, the array
contents are indeterminate.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
A pointer to <i>buf</i>, or a null pointer if an error occurs or end-of-file is
encountered and no characters have been read.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiStdio.html#top">ansiStdio</a></b>, <b><a href="./ansiStdio.html#fread">fread</a>(&nbsp;)</b>, <b><a href="./ansiStdio.html#fgetc">fgetc</a>(&nbsp;)</b>

<hr>
<a name="fileno"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>fileno(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>fileno(&nbsp;)</strong> - return the file descriptor for a stream (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int fileno
    (
    FILE * fp                 /* stream */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the file descriptor associated with a specified
stream.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
The file descriptor, or -1 if an error occurs, with <b>errno</b> set to indicate
the error.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiStdio.html#top">ansiStdio</a></b>, * .I "Information Technology - POSIX - Part 1:"
<i>System API [C Language], IEEE Std 1003.1</i>

<hr>
<a name="fopen"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>fopen(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>fopen(&nbsp;)</strong> - open a file specified by name (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>FILE * fopen
    (
    const char * file,        /* name of file */
    const char * mode         /* mode */