fwscanf()

Updated: April 19, 2023

Scan wide-character input from a stream

Synopsis:

#include <wchar.h>

int fwscanf( FILE * fp,
             const wchar_t * format, 
             ... );

Arguments:

fp
The stream that you want to read from.
format
A wide-character string that specifies the format of the input. For more information, see scanf(). The formatting string determines what additional arguments you need to provide.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The fwscanf() function scans input from the stream specified by fp, under control of the argument format. Following the format string is a list of addresses to receive values.

The fwscanf() function is the wide-character version of fscanf().

Note: The fwscanf() function is generally considered unsafe for string handling; it's safer to use fgetws() to get a line of input and then use swscanf() to process the input.

Returns:

The number of input arguments for which values were successfully scanned and stored, or EOF if the scanning reached the end of the input stream before storing any values.

Classification:

ANSI, POSIX 1003.1

Safety:  
Cancellation point Yes
Interrupt handler No
Signal handler No
Thread Yes