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.
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)