fwscanf_s.c File Reference

#include "safe_str_lib.h"

Include dependency graph for fwscanf_s.c:

Functions
EXPORT int	fwscanf_s (FILE *restrict stream, const wchar_t *restrict fmt,...)
	The fwscanf_s function reads a formatted wide string. More...

Function Documentation

fwscanf_s()

EXPORT int fwscanf_s	(	FILE *restrict	stream,
		const wchar_t *restrict	fmt,
			...
	)

The fwscanf_s function reads a formatted wide string.

Reaching the end of the string is equivalent to reaching the end-of-file condition for fwscanf.

Remarks

SPECIFIED IN

• C11 standard (ISO/IEC 9899:2011): K.3.9.1.7 The fwscanf_s function (p: 632-633) http://en.cppreference.com/w/c/io/fwscanf

Parameters

[in]	stream	pointer to a FILE stream to read from
[in]	fmt	format-control wide string.
[out]	...	arguments to write to

Precondition

Neither stream nor fmt shall be a null pointer.

fmt shall not contain the conversion specifier n

None of the arguments corresponding to s is a null pointer. (not yet) Note it currently even crashes with a NULL pointer.

No encoding error shall occur.

c, s, and %[ conversion specifiers each expect two arguments (the usual pointer and a value of type rsize_t indicating the size of the receiving array, which may be 1 when reading with a lc into a single wide character) and except that the following errors are detected at runtime and call the currently installed constraint handler function.

Returns

Number of receiving arguments successfully assigned, or EOF if read failure occurs before the first receiving argument was assigned or if there is a runtime constraint violation.

Return values

>	0 on success, the number of arguments assigned
EOF	on error

See also

vswscanf_s(), wscanf_s(), vfwscanf_s(), vfwprintf_s()