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)
