NOME

       fgetws - lê uma string de caracteres largos a partir de um fluxo de arquivo

SINOPSE

       #include <wchar.h>

       wchar_t *fgetws (wchar_t *ws, int n, FILE *stream);

DESCRIÇÃO

       A função fgetws é a equivalente para caracteres largos da função fgets.  Ela lê uma string
       de, no máximo, n-1 caracteres largos e coloca na matriz de caracteres largos apontada  por
       ws, e adiciona um caractere de terminação L'\0'.  Ela pára de ler caracteres largos depois
       que encontra e armazena um caractere largo de nova linha. Ela também pára quando o fim  do
       fluxo é atingido.

       O programador precisa assegurar-se de que há espaço para pelo menos n caracteres largos em
       ws.

VALOR DE RETORNO

       A função fgetws, se bem-sucedida, retorna ws. Se o fim do fluxo já foi encontrado,  ou  se
       ocorreu um erro, ela retorna NULL.

CONFORME

       ISO/ANSI C, UNIX98

VEJA TAMBÉM

       fgetwc(3)

NOTAS

       O comportamento de fgetws depende da categoria LC_CTYPE do 'locale' corrente.

       Na  ausência de informações adicionais passadas para a chamada 'fopen', é razoável esperar
       que fgetws irá ler, no momento, uma string multibyte a partir do fluxo e então convertê-la
       para uma string de caracteres largos.

       Esta  função  não  é  confiável, porque ela não permite lidar adequadamente com caracteres
       largos nulos que possam estar presentes na entrada.

TRADUÇÃO PARA A LÍNGUA PORTUGUESA

       RUBENS  DE  JESUS  NOGUEIRA  <darkseid99@usa.net>  (tradução)  XXXXXX  XX  XXXXX  XXXXXXXX
       <xxxxxxxxxx@xxx.xxx> (revisão)