QNX Developer Support
![[Previous]](../prev.gif) |
![[Contents]](../contents.gif) |
![[Index]](../keyword_index.gif) |
![[Next]](../next.gif) |
getwc()
Read a wide character from a stream
Synopsis:
#include <wchar.h> wint_t getwc( FILE * fp );
Arguments:
- fp
- The stream from which you want to read a wide character.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The getwc() function reads the next wide character from the specified stream.
Returns:
The next character from the stream, cast as (wint_t)(wchar_t), or WEOF if end-of-file has been reached or if an error occurs (errno is set).
 |
Use feof() or ferror() to distinguish an end-of-file condition from an error. |
Errors:
- EAGAIN
- The O_NONBLOCK flag is set for fp and would have been blocked by this operation.
- EBADF
- The fp stream isn't valid for reading.
- EINTR
- A signal terminated the read operation; no data was transferred.
- EIO
- Either a physical I/O error has occurred, or the process is in the background and is being ignored or blocked.
- EOVERFLOW
- Cannot read at or beyond the offset maximum for this stream.
Classification:
| Safety: | |
|---|---|
| Cancellation point | Yes |
| Interrupt handler | No |
| Signal handler | No |
| Thread | Yes |
See also:
errno, feof(), ferror(), putwc(), putwchar()
"Stream I/O functions" and "Wide-character functions" in the summary of functions chapter
|
|
|
|
