| fgetws(3) | Library Functions Manual | fgetws(3) |
fgetws - lê uma sequência de caracteres largos a partir de um fluxo de arquivo
Biblioteca C Padrão (libc, -lc)
#include <wchar.h>
wchar_t *fgetws(wchar_t ws[restrict .n], int n, ARQUIVO *restrict stream);
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).
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.
Para uma explicação dos termos usados nesta seção, consulte attributes(7).
| Interface | Atributo | Valor |
| fgetws() | Thread safety | MT-Safe |
C11, POSIX.1-2008.
POSIX.1-2001, C99.
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.
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.
| 15 junho 2024 | Linux man-pages 6.9.1 |