ansistdio.html

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

received a conversion result.  If this object does not have an appropriate
type, or if the result of the conversion cannot be represented in the
space provided, the behavior is undefined.
<p>
The following conversion specifiers are valid:
<p>
<dl>
<dt>
<b>d</b>
<dd>
Matches an optionally signed decimal integer whose format is
the same as expected for the subject sequence of the <b><a href="./ansiStdlib.html#strtol">strtol</a>(&nbsp;)</b>
function with the value 10 for the <i>base</i> argument.  The 
corresponding argument should be a pointer to <b>int</b>.
<dt>
<b>i</b>
<dd>
Matches an optionally signed integer, whose format is the
same as expected for the subject sequence of the <b><a href="./ansiStdlib.html#strtol">strtol</a>(&nbsp;)</b>
function with the value 0 for the <i>base</i> argument.  The 
corresponding argument should be a pointer to <b>int</b>.
<dt>
<b>o</b>
<dd>
Matches an optionally signed octal integer, whose format is the
same as expected for the subject sequence of the <b><a href="./ansiStdlib.html#strtoul">strtoul</a>(&nbsp;)</b>
function with the value 8 for the <i>base</i> argument.  The
corresponding argument should be a pointer to <b>unsigned int</b>.
<dt>
<b>u</b>
<dd>
Matches an optionally signed decimal integer, whose format is 
the same as expected for the subject sequence of the <b><a href="./ansiStdlib.html#strtoul">strtoul</a>(&nbsp;)</b>
function with the value 10 for the <i>base</i> argument.  The
corresponding argument should be a pointer to <b>unsigned int</b>.
<dt>
<b>x</b>
<dd>
Matches an optionally signed hexadecimal integer, whose format is
the same as expected for the subject sequence of the <b><a href="./ansiStdlib.html#strtoul">strtoul</a>(&nbsp;)</b>
function with the value 16 for the <i>base</i> argument.  The
corresponding argument should be a pointer to <b>unsigned int</b>.
<dt>
<b>e</b>, <b>f</b>, <b>g</b>
<dd>
Match an optionally signed floating-point number, whose format
is the same as expected for the subject string of the <b><a href="./ansiStdlib.html#strtod">strtod</a>(&nbsp;)</b>
function.  The corresponding argument should be a pointer to <b>float</b>.
<dt>
<b>s</b>
<dd>
Matches a sequence of non-white-space characters.  The 
corresponding argument should be a pointer to the initial
character of an array large enough to accept the sequence
and a terminating null character, which will be added 
automatically.
<dt>
<b>[</b>
<dd>
Matches a non-empty sequence of characters from a set of 
expected characters (the <b>scanset</b>).  The corresponding argument
should be a pointer to the initial character of an array large
enough to accept the sequence and a terminating null character,
which is added automatically.  The conversion specifier
includes all subsequent character in the format string, up to
and including the matching right bracket (<b>]</b>).  The characters
between the brackets (the <b>scanlist</b>) comprise the scanset,
unless the character after the left bracket is a circumflex (<b>^</b>)
in which case the scanset contains all characters that do not
appear in the scanlist between the circumflex and the right
bracket.  If the conversion specifier begins with "[]" or "[^]", the
right bracket character is in the scanlist and the next 
right bracket character is the matching right bracket that ends
the specification; otherwise the first right bracket character
is the one that ends the specification.
<dt>
<b>c</b>
<dd>
Matches a sequence of characters of the number specified by the
field width (1 if no field width is present in the directive).
The corresponding argument should be a pointer to the initial 
character of an array large enough to accept the sequence.
No null character is added.
<dt>
<b>p</b>
<dd>
Matches an implementation-defined set of sequences, which should be
the same as the set of sequences that may be produced by the %p
conversion of the <b><a href="./ansiStdio.html#fprintf">fprintf</a>(&nbsp;)</b> function.  The corresponding argument
should be a pointer to a pointer to <b>void</b>.  VxWorks defines its
pointer input field to be consistent with pointers written by the
<b><a href="./ansiStdio.html#fprintf">fprintf</a>(&nbsp;)</b> function ("0x" hexadecimal notation).  If the input item is
a value converted earlier during the same program execution, the
pointer that results should compare equal to that value; otherwise
the behavior of the %p conversion is undefined.
<dt>
<b>n</b>
<dd>
No input is consumed.  The corresponding argument should be a pointer to
<b>int</b> into which the number of characters read from the input stream so
far by this call to <b><a href="./ansiStdio.html#fscanf">fscanf</a>(&nbsp;)</b> is written.  Execution of a %n directive does
not increment the assignment count returned when <b><a href="./ansiStdio.html#fscanf">fscanf</a>(&nbsp;)</b> completes
execution.
<dt>
<b>%</b>
<dd>
Matches a single <b>%</b>; no conversion or assignment occurs.  The
complete conversion specification is %%.
</dl>

<p>
If a conversion specification is invalid, the behavior is undefined.
<p>
The conversion specifiers <b>E</b>, <b>G</b>, and <b>X</b> are also valid and behave the
same as <b>e</b>, <b>g</b>, and <b>x</b>, respectively.
<p>
If end-of-file is encountered during input, conversion is terminated.  If 
end-of-file occurs before any characters matching the current directive
have been read (other than leading white space, where permitted), execution
of the current directive terminates with an input failure; otherwise, unless
execution of the current directive is terminated with a matching failure,
execution of the following directive (if any) is terminated with an input
failure.
<p>
If conversion terminates on a conflicting input character, the offending
input character is left unread in the input stream.  Trailing white space
(including new-line characters) is left unread unless matched by a
directive.  The success of literal matches and suppressed assignments is
not directly determinable other than via the %n directive.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
The number of input items assigned, which can be fewer than provided for,
or even zero, in the event of an early matching failure; or EOF if an
input failure occurs before any conversion.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./ansiStdio.html#top">ansiStdio</a></b>, <b><a href="./ansiStdio.html#scanf">scanf</a>(&nbsp;)</b>, <b><a href="./fioLib.html#sscanf">sscanf</a>(&nbsp;)</b>

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

</blockquote><h1>fseek(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>fseek(&nbsp;)</strong> - set the file position indicator for a stream (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int fseek
    (
    FILE * fp,                /* stream */
    long   offset,            /* offset from <i>whence</i> */
    int    whence             /* position to offset from: SEEK_SET = */
                              /* beginning SEEK_CUR = current position */
                              /* SEEK_END = end-of-file */ 
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine sets the file position indicator for a specified stream.
For a binary stream, the new position, measured in characters from the 
beginning of the file, is obtained by adding <i>offset</i> to the position 
specified by <i>whence</i>, whose possible values are:
<dl>
<dt>
<b>SEEK_SET</b>
<dd>
the beginning of the file.
<dt>
<b>SEEK_CUR</b>
<dd>
the current value of the file position indicator.
<dt>
<b>SEEK_END</b>
<dd>
the end of the file.
</dl>
A binary stream does not meaningfully
support <b><a href="./ansiStdio.html#fseek">fseek</a>(&nbsp;)</b> calls with a <i>whence</i> value of <b>SEEK_END</b>.
<p>
For a text stream, either <i>offset</i> is zero, or <i>offset</i> is a value
returned by an earlier call to <b><a href="./ansiStdio.html#ftell">ftell</a>(&nbsp;)</b> on the stream, in which case
<i>whence</i> should be <b>SEEK_SET</b>.
<p>
A successful call to <b><a href="./ansiStdio.html#fseek">fseek</a>(&nbsp;)</b> clears the end-of-file indicator for the
stream and undoes any effects of <b><a href="./ansiStdio.html#ungetc">ungetc</a>(&nbsp;)</b> on the same stream.  After an
<b><a href="./ansiStdio.html#fseek">fseek</a>(&nbsp;)</b> call, the next operation on an update stream can be either input
or output.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
Non-zero only for a request that cannot be satisfied.
<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#ftell">ftell</a>(&nbsp;)</b>

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

</blockquote><h1>fsetpos(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>fsetpos(&nbsp;)</strong> - set the file position indicator for a stream (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int fsetpos
    (
    FILE *         iop,       /* stream */
    const fpos_t * pos        /* position, obtained by fgetpos() */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine sets the file position indicator for a specified stream <i>iop</i>
according to the value of the object pointed to by <i>pos</i>, which is a value
obtained from an earlier call to <b><a href="./ansiStdio.html#fgetpos">fgetpos</a>(&nbsp;)</b> on the same stream.
<p>
A successful call to <b><a href="./ansiStdio.html#fsetpos">fsetpos</a>(&nbsp;)</b> clears the end-of-file indicator for the
stream and undoes any effects of <b><a href="./ansiStdio.html#ungetc">ungetc</a>(&nbsp;)</b> on the same stream.  After an
<b><a href="./ansiStdio.html#fsetpos">fsetpos</a>(&nbsp;)</b> call, the next operation on an update stream may be either input
or output.
<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 the call fails, 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#fgetpos">fgetpos</a>(&nbsp;)</b>

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

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

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>long ftell
    (
    FILE * fp                 /* stream */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns the current value of the file position indicator for
a specified stream.  For a binary stream, the value is the number of
characters from the beginning of the file.  For a text stream, the file
position indicator contains unspecified information, usable by <b><a href="./ansiStdio.html#fseek">fseek</a>(&nbsp;)</b> for
returning the file position indicator to its position at the time of the
<b><a href="./ansiStdio.html#ftell">ftell</a>(&nbsp;)</b> call; the difference between two such return values is not
necessary a meaningful measure of the number of characters written or read.
<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>stdio.h</b> 
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
The current value of the file position indicator,
or -1L 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#fseek">fseek</a>(&nbsp;)</b>

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

</blockquote><h1>fwrite(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>fwrite(&nbsp;)</strong> - write from a specified array (ANSI)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int fwrite
    (
    const void * buf,         /* where to copy from */
    size_t       size,        /* element size */
    size_t       count,       /* no. of elements */
    FILE *       fp           /* stream to write to */
    )