fgetws(3)                  Library Functions Manual                  fgetws(3)

NOME
       fgetws - le uma sequencia de caracteres largos a partir de um fluxo de
       arquivo

BIBLIOTECA
       Biblioteca C Padrao (libc, -lc)

SINOPSE
       #include <wchar.h>

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

DESCRICAO
       The fgetws()  function is the wide-character equivalent of the fgets(3)
       function.  It reads a string of at most n-1 wide characters into the
       wide-character array pointed to by ws, and adds a terminating null wide
       character (L'\0').  It stops reading wide characters after it has
       encountered and stored a newline wide character.  It also stops when
       end of stream is reached.

       O programador precisa assegurar-se de que ha espaco para pelo menos n
       caracteres largos em ws.

       Para uma contraparte nao-bloqueante, veja unlocked_stdio(3).

VALOR DE RETORNO
       A funcao fgetws(), se bem-sucedida, retorna ws. Se o fim do fluxo ja
       foi encontrado, ou se ocorreu um erro, ela retorna NULL.

ATRIBUTOS
       Para uma explicacao dos termos usados nesta secao, consulte
       attributes(7).

       +--------------------------------------------+---------------+---------+
       |Interface                                   | Atributo      | Valor   |
       +--------------------------------------------+---------------+---------+
       |fgetws()                                    | Thread safety | MT-Safe |
       +--------------------------------------------+---------------+---------+
PADROES
       C11, POSIX.1-2008.

HISTORICO
       POSIX.1-2001, C99.

NOTAS
       O comportamento de fgetws() depende da categoria LC_CTYPE da
       localizacao atual.

       Na ausencia de informacoes adicionais passadas para a chamada fopen(3),
       e razoavel esperar que fgetws() ira ler, no momento, uma sequencia
       multibyte a partir do fluxo e entao converte-la para uma sequencia de
       caracteres largos.

       Esta funcao nao e confiavel, porque ela nao permite lidar adequadamente
       com caracteres largos nulos que possam estar presentes na entrada.

VEJA TAMBEM
       fgetwc(3), unlocked_stdio(3)

TRADUCAO
       A traducao para portugues brasileiro desta pagina man foi criada por
       Rubens de Jesus Nogueira <darkseid99@usa.net> e Andre Luiz Fassone
       <lonely_wolf@ig.com.br>

       Esta traducao e uma documentacao livre; leia a Licenca Publica Geral
       GNU Versao 3 <https://www.gnu.org/licenses/gpl-3.0.html> ou posterior
       para as condicoes de direitos autorais.  Nenhuma responsabilidade e
       aceita.

       Se voce encontrar algum erro na traducao desta pagina de manual, envie
       um e-mail para a lista de discussao de tradutores
       <debian-l10n-portuguese@lists.debian.org>.

Linux man-pages 6.06            31 outubro 2023                      fgetws(3)