NOME

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

BIBLIOTECA

       Biblioteca C Padrão (libc, -lc)

SINOPSE

       #include <wchar.h>

       wchar_t *fgetws(wchar_t ws[restrict .n], int n, ARQUIVO *restrict stream);

DESCRIÇÃO

       A  função fgetws() é a equivalente para caracteres largos da função fgets(3). Ela lê uma sequência 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 nulo (L'\0'). Ela para de ler caracteres largos depois que encontra e armazena um
       caractere largo de nova linha. Ela também para quando o fim do fluxo é atingido.

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

       Para uma contraparte não-bloqueante, veja unlocked_stdio(3).

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.

ATRIBUTOS

       Para uma explicação dos termos usados nesta seção, consulte attributes(7).
       ┌─────────────────────────────────────────────────────────────────────────────┬───────────────┬─────────┐
       │ Interface                                                                   │ Atributo      │ Valor   │
       ├─────────────────────────────────────────────────────────────────────────────┼───────────────┼─────────┤
       │ fgetws()                                                                    │ Thread safety │ MT-Safe │
       └─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘

PADRÕES

       C11, POSIX.1-2008.

HISTÓRICO

       POSIX.1-2001, C99.

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(3), é razoável esperar  que  fgetws()
       irá  ler, no momento, uma sequência multibyte a partir do fluxo e então convertê-la para uma sequência 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.

VEJA TAMBÉM

       fgetwc(3), unlocked_stdio(3)

TRADUÇÃO

       A  tradução  para  português  brasileiro  desta  página  man  foi  criada  por  Rubens  de Jesus Nogueira
       <darkseid99@usa.net>,    André    Luiz    Fassone    <lonely_wolf@ig.com.br>    e    Rafael    Fontenelle
       <rafaelff@gnome.org>.

       Esta  tradução  é  uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as
       condições de direitos autorais.  Nenhuma responsabilidade é aceita.

       Se você encontrar algum erro na tradução  desta  página  de  manual,  envie  um  e-mail  para  a lista de
       discussão de tradutores.

Linux man-pages 6.9.1                             15 junho 2024                                        fgetws(3)