Provided by: manpages-pt-dev_20040726-4_all bug

NOME

       fgetws  -  le  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,C~AO

       A funcao fgetws e a equivalente para caracteres largos da funcao fgets.
       Ela  le  uma  string  de,  no maximo, n-1 caracteres largos e coloca na
       matriz de caracteres largos apontada por ws, e adiciona um caractere de
       terminacao  L'\0'.   Ela  para  de  ler  caracteres  largos  depois que
       encontra e armazena um caractere largo de nova linha. Ela  tambem  para
       quando o fim do fluxo e atingido.

       O  programador  precisa assegurar-se de que ha espaco para pelo menos n
       caracteres largos em ws.

VALOR DE RETORNO

       A funcao fgetws, se bem-sucedida, retorna ws. Se o fim do fluxo ja  foi
       encontrado, ou se ocorreu um erro, ela retorna NULL.

CONFORME

       ISO/ANSI C, UNIX98

VEJA TAMB'EM

       fgetwc(3)

NOTAS

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

       Na ausencia de informacoes adicionais passadas para a chamada  'fopen',
       e razoavel esperar que fgetws ira ler, no momento, uma string multibyte
       a partir do fluxo e entao converte-la para  uma  string  de  caracteres
       largos.

       Esta funcao nao e confiavel, porque ela nao permite lidar adequadamente
       com caracteres largos nulos que possam estar presentes na entrada.

TRADU,C~AO PARA A L'INGUA PORTUGUESA

       RUBENS DE JESUS  NOGUEIRA  <darkseid99@usa.net>  (traducao)  XXXXXX  XX
       XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx> (revisao)