getws(3W)                      DG/UX 5.4R3.00                      getws(3W)


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

SYNOPSIS
       #include <stdio.h>
       #include <widec.h>
       wchart *getws(wchart *s);
       wchart *fgetws(wchart *s, int n, FILE *stream);

DESCRIPTION (International Functions)
       getws() reads EUC characters from stdin, converts them to wchart
       characters, and places them in the wchart 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 wchart string is terminated with a wchart null character.

       fgetws() reads EUC characters from the stream, converts them to
       wchart characters, and places them in the wchart array pointed to
       by s.  fgetws() reads until n-1 wchart characters are transferred to
       s, or a new-line character or an end-of-file condition is
       encountered.  The wchart string is then terminated with a wchart
       null character.

DIAGNOSTICS
       If end-of-file or a read error is encountered and no characters have
       been transformed, no wchart 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).























Licensed material--property of copyright holder(s)                         1