get a line of wide characters from a stream
* restrict ws, int
n, FILE * restrict
fgetws() function reads at most one less than the
number of characters specified by n from the given
fp and stores them in the wide-character string
ws. Reading stops when a newline character is found, at
end-of-file, or error. The newline, if any, is retained. If any characters are
read and there is no error, a ‘
character is appended to end the string.
Upon successful completion,
ws. If end-of-file occurs before any characters are
and the buffer contents remain unchanged. If an error occurs,
NULL and the
buffer contents are indeterminate. The
function does not distinguish between end-of-file and error, and callers must
use feof(3) and
ferror(3) to determine which occurred.
- The given fp argument is not a readable stream.
- The data obtained from the input stream does not form a valid multibyte
fgetws() may also fail and
set errno for any of the errors specified for the
fgetws() function conforms to IEEE
Std 1003.1-2001 (“POSIX.1”).