String Format Function

int fscanf(FILE *stream, const char *format [, argument ]...);

int fwscanf(FILE *stream, const wchar_t *format [, argument ]...);

int _ftscanf(FILE *stream, const TCHAR *format [, argument ]...);

Internationalization (I18n) Function Overview

The fscanf function scans data from the current position in stream into the locations given by argument, under the control of the format specification. The number of converted fields is returned, or EOF in the event of an error. The behavior of fscanf is undefined if copying takes place between strings that overlap.

fwscanf is the wide character version of fscanf; its format argument is a wide-character string.

_ftscanf is the Windows-only Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either fscanf or fwscanf.

I18n Issues

Use the appropriate version of the function as required for internationalization support, noting the following:

Prior to calling one of these functions, ensure that the current locale is set properly by calling setlocale, as string formatting is dependent on the LC_NUMERIC locale category. See String Formatting in C and C++ for a discussion on locale-sensitive formatting in internationalized applications.

Recommended Replacements*

ANSI UTF-8	fscanf
ANSI UTF-16	fwscanf
Microsoft Windows MBCS	fscanf
Microsoft Windows Unicode	fwscanf
Microsoft Windows Generic	_ftscanf

String Format Functions