fgetws

Defined in header <wchar.h>
wchar_t * fgetws ( wchar_t * str, int count, FILE * stream ) ;		(since C95) (until C99)
wchar_t * fgetws ( wchar_t * restrict str, int count, FILE * restrict stream ) ;		(since C99)

Reads at most count - 1 wide characters from the given file stream and stores them in str . The produced wide string is always null-terminated. Parsing stops if end-of-file occurs or a newline wide character is found, in which case str will contain that wide newline character.

Parameters

str	-	wide string to read the characters to
count	-	the length of str
stream	-	file stream to read the data from

Return value

str on success, a null pointer on an error

Example

This section is incomplete Reason: no example

References

See also

wscanf fwscanf swscanf wscanf_s fwscanf_s swscanf_s (C95) (C95) (C95) (C11) (C11) (C11)	reads formatted wide character input from stdin , a file stream or a buffer (function)
fgetwc getwc (C95)	gets a wide character from a file stream (function)
fputws (C95)	writes a wide string to a file stream (function)
getline getwline getdelim getwdelim (dynamic memory TR)	read from a stream into an automatically resized buffer until delimiter/end of line (function)
C++ documentation for fgetws