NOME¶

fwide - seleciona e determina a orientação do fluxo de arquivo

BIBLIOTECA¶

Biblioteca C Padrão (libc, -lc)

SINOPSE¶

#include <wchar.h>

int fwide(FILE *fluxo, int modo);

fwide():

    _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE


        || _POSIX_C_SOURCE >= 200112L

DESCRIÇÃO¶

When mode is zero, the fwide() function determines the current orientation of stream. It returns a positive value if stream is wide-character oriented, that is, if wide-character I/O is permitted but char I/O is disallowed. It returns a negative value if stream is byte oriented—that is, if char I/O is permitted but wide-character I/O is disallowed. It returns zero if stream has no orientation yet; in this case the next I/O operation might change the orientation (to byte oriented if it is a char I/O operation, or to wide-character oriented if it is a wide-character I/O operation).

Uma vez que um fluxo tem uma orientação, ele não pode ser mudado e persiste até que o fluxo seja fechado.

Quando modo é diferente de zero, a função fwide() primeiro tenta definir a orientação do fluxo (para orientado a caractere largo se modo for maior que 0, ou para orientado a byte se modo for menor que 0). Ela retorna um valor denotando a orientação atual, como visto acima.

VALOR DE RETORNO¶

A função fwide() retorna a orientação do fluxo, depois de possivelmente mudá-la. Um valor de retorno positivo significa orientação a caracteres largos. Um valor de retorno negativo significa orientação a byte. Um valor de retorno significa indecisão.

PADRÕES¶

POSIX.1-2001, POSIX.1-2008, C99.

NOTAS¶

Saída de caracteres largos para um fluxo orientado a byte pode ser realizado através da função fprintf(3) com as diretivas %lc e %ls.

Saída orientada a caracteres para um fluxo orientado a caracteres largos pode ser realizado através da função fwprintf(3) com as diretivas %c e %s.

VEJA TAMBÉM¶

fprintf(3), fwprintf(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.