![]() |
![]() |
![]() |
![]() |
![]() |
This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs. |
Read a string of wide characters from a stream
#include <wchar.h> wchar_t * fgetws( wchar_t * buf, int n, FILE * fp );
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The fgetws() function reads a string of wide characters from the stream specified by fp, and stores them in the array specified by buf.
It stops reading wide characters when one of the following occurs:
The fgetws() function places a NUL at the end of the string.
![]() |
Don't assume all strings have newline characters.
A newline character isn't present when more than
n-1 characters occur before the newline.
Also, a newline character might not appear as the last character in a file when the end-of-file is reached. |
![]() |
Use feof() or ferror() to distinguish an end-of-file condition from an error. |
Safety: | |
---|---|
Cancellation point | Yes |
Interrupt handler | No |
Signal handler | No |
Thread | Yes |
errno, feof(), ferror(), fputws()
"Stream I/O functions" and "Wide-character functions" in the summary of functions chapter.
![]() |
![]() |
![]() |
![]() |