OSF

NAME

getws, fgetws − Gets a string from a stream

LIBRARY

Standard I/O Library (libc.a)

SYNOPSIS

#include <NLchar.h>
NLchar ∗getws (
NLchar ∗string );
NLchar ∗fgetws (
NLchar ∗string,
int number,
FILE ∗stream );

PARAMETERS

stringPoints to a string to receive characters. 

streamPoints to the FILE structure of an open file. 

numberSpecifies an upper bound on the number of characters to read. 

DESCRIPTION

The getws() and fgetws() functions are provided when Japanese Language Support is installed on your system.  They parallel the gets() and fgets() functions. 

The getws() function transforms multibyte character input values to uniform NLchar width.The fgetws() function also expands 1-byte and 2-byte character input values to uniform NLchar (2-byte) width. 

RETURN VALUES

If the end of the file is encountered and no characters have been read, no characters are transferred to the string parameter and a null pointer is returned. If a read error occurs, a null pointer is returned. Otherwise, string is returned. 

RELATED INFORMATION

Functions: clearerr(3), feof(3), ferror(3), fileno(3), fopen(3), fread(3), getc(3), gets(3), getwc(3), puts(3), putws(3), scanf(3)