Inputs a wide string from a stream input/output file.

[Format]

#include <stdio.h>

#include <wchar.h>

wchar_t *fgetws(wchar_t *restrict s, long n, FILE *fp);

[Parameters]

s Pointer to storage area to which wide string is input

n Number of bytes of storage area to which wide string is input

fp File pointer

[Return values]

Normal: End-of-file: NULL

Otherwise: s

Abnormal: NULL

[Remarks]

The fgetws function is provided to support wide-character input to the fgets function.