getws(3S)getws(3S)NAME
getws, fgetws - get a wchar_t string from a stream
SYNOPSIS
#include <stdio.h>
#include <widec.h>
wchar_t *getws(wchar_t *s);
wchar_t *fgetws(wchar_t *s, int n, FILE *stream);
DESCRIPTION (International Functions)
getws reads EUC characters from stdin, converts them to wchar_t
characters, and places them in the wchar_t array pointed to by s. getws
reads until a newline character is read or an end-of-file condition is
encountered. The newline character is discarded and the wchar_t string
is terminated with a wchar_t null character.
fgetws reads EUC characters from the stream, converts them to wchar_t
characters, and places them in the wchar_t array pointed to by s. fgetws
reads until n-1 wchar_t characters are transferred to s, or a newline
character or an end-of-file condition is encountered. The wchar_t string
is then terminated with a wchar_t null character.
SEE ALSOferror(3S), fopen(3S), fread(3S), scanf(3S), stdio(3S), getwc(3S),
widec(3S).
DIAGNOSTICS
If end-of-file or a read error is encountered and no characters have been
transformed, no wchar_t characters are transferred to s and a null
pointer is returned and the error indicator for the stream is set. If
the read error is an illegal byte sequence, errno is set to EILSEQ. If
end-of-file is encountered, the EOF indicator for the stream is set.
Otherwise, s is returned.
Page 1
