getws(3S)							     getws(3S)

NAME    [Toc]    [Back]

     getws, fgetws - get a wchar_t string from a stream

SYNOPSIS    [Toc]    [Back]

     #include <stdio.h>
     #include <widec.h>

     wchar_t *getws(wchar_t *s<b>);
     wchar_t *fgetws(wchar_t *s<b>, int n<b>,	FILE *stream<b>);

DESCRIPTION (International Functions)    [Toc]    [Back]

     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 ALSO    [Toc]    [Back]

     ferror(3S), fopen(3S), fread(3S), scanf(3S), stdio(3S), getwc(3S),
     widec(3S).

DIAGNOSTICS    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111