📄 fgetws.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>fgetws</title></head><body bgcolor=white><center><font size=2>The Single UNIX ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_000_005_077"> </a>NAME</h4><blockquote>fgetws - get a wide-character string from a stream</blockquote><h4><a name = "tag_000_005_078"> </a>SYNOPSIS</h4><blockquote><pre><code>#include <<a href="stdio.h.html">stdio.h</a>>#include <<a href="wchar.h.html">wchar.h</a>>wchar_t *fgetws(wchar_t *<i>ws</i>, int <i>n</i>, FILE *<i>stream</i>);</code></pre></blockquote><h4><a name = "tag_000_005_079"> </a>DESCRIPTION</h4><blockquote>The<i>fgetws()</i>function reads characters from the<i>stream</i>,converts these to the corresponding wide-character codes,places them in the<b>wchar_t</b>array pointed to by<i>ws</i>,until<i>n</i>-1characters are read, or a newlinecharacter is read, converted and transferred to<i>ws</i>,or an end-of-file condition is encountered.The wide-character string,<i>ws</i>,is then terminated with anull wide-character code.<p>If an error occurs, the resulting value of the file positionindicator for the stream is indeterminate.<p>The<i>fgetws()</i>function may mark the<i>st_atime</i>field of the file associated with<i>stream</i>for update.The<i>st_atime</i>field will be marked for update by the first successfulexecution of<i><a href="fgetc.html">fgetc()</a></i>,<i><a href="fgets.html">fgets()</a></i>,<i><a href="fgetwc.html">fgetwc()</a></i>,<i>fgetws()</i>,<i><a href="fread.html">fread()</a></i>,<i><a href="fscanf.html">fscanf()</a></i>,<i><a href="getc.html">getc()</a></i>,<i><a href="getchar.html">getchar()</a></i>,<i><a href="gets.html">gets()</a></i>or<i><a href="scanf.html">scanf()</a></i>using<i>stream</i>that returns data not supplied by a prior call to<i><a href="ungetc.html">ungetc()</a></i>or<i><a href="ungetwc.html">ungetwc()</a></i>.</blockquote><h4><a name = "tag_000_005_080"> </a>RETURN VALUE</h4><blockquote>Upon successful completion,<i>fgetws()</i>returns<i>ws.</i>If the stream is at end-of-file, the end-of-file indicator forthe stream is set and<i>fgetws()</i>returns a null pointer.If a read error occurs, the error indicator for the stream is set,<i>fgetws()</i>returns a null pointer and sets<i>errno</i>to indicate the error.</blockquote><h4><a name = "tag_000_005_081"> </a>ERRORS</h4><blockquote>Refer to<i><a href="fgetwc.html">fgetwc()</a></i>.</blockquote><h4><a name = "tag_000_005_082"> </a>EXAMPLES</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_083"> </a>APPLICATION USAGE</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_084"> </a>FUTURE DIRECTIONS</h4><blockquote>None.</blockquote><h4><a name = "tag_000_005_085"> </a>SEE ALSO</h4><blockquote><i><a href="fopen.html">fopen()</a></i>,<i><a href="fread.html">fread()</a></i>,<i><a href="stdio.h.html"><stdio.h></a></i>,<i><a href="wchar.h.html"><wchar.h></a></i>.</blockquote><h4>DERIVATION</h4><blockquote>Derived from the MSE working draft.</blockquote><hr size=2 noshade><center><font size=2>UNIX ® is a registered Trademark of The Open Group.<br>Copyright © 1997 The Open Group<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]</font></center><hr size=2 noshade></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -