FGETWS(3)

NOME
fgetws - lê uma seqüencia de caracteres largos a partir de um fluxo de arquivo

SINÓPSE
#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 seqüencia 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.

VALORES RETORNADOS
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.

DE ACORDO COM
ISO/ANSI C, UNIX98.

VEJA TAMBÉM
fgetwc(3).

NOTAS
O comportamento de fgetws depende da categoria LC_CTYPE da localização atual.

Na ausência de informações adicionais passadas para a chamada 'fopen', é razoável esperar que fgetws irá ler, no momento, uma seqüencia multibyte a partir do fluxo e então convertê-la para uma seqüencia 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.

TRADUZIDO POR LDP-BR em 21/08/2000.

  Tradução:
Rubens de Jesus Nogueira <darkseid99@usa.net>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>