GETWS(3W-SVR4)      RISC/os Reference Manual       GETWS(3W-SVR4)



NAME
     getws, fgetws - get a wchar_t string from a stream

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

     wchart *getws(wchart *s);
     wchart *fgetws(wchart *s, int n, FILE *stream);

DESCRIPTION
     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 new-line character
     is read or an end-of-file condition is encountered.  The
     new-line 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 charac-
     ters are transferred to s, or a new-line character or an
     end-of-file condition is encountered.  The wchar_t string is
     then terminated with a wchar_t null character.

DIAGNOSTICS
     If end-of-file or a read error is encountered and no charac-
     ters 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, EILSEQ is set to errno.  If end-
     of-file is encountered, the EOF indicator for the stream is
     set.  Otherwise, s is returned.

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


















                        Printed 11/19/92                   Page 1