FWIDE(3)

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

SINÓPSE
#include <wchar.h>

int fwide (FILE* stream, int mode);

DESCRIÇÃO
Quando mode é zero, a função fwide determina a orientação corrente do fluxo. Ela retorna um valor > 0 se o fluxo é orientado a caracteres largos, isto é, se E/S de caracteres largos é permitido mas E/S de caracteres está desabilitado. Ela retorna um valor < 0 se o fluxo é orientado a byte, isto é, se E/S de caracteres é permitido mas E/S de caracteres largos está desabilitado. Ela retorna zero se o fluxo ainda não tem orientação; neste caso, a próxima operação de E/S pode mudar a orientação (para orientado a byte se for uma operação de E/S de caractere, ou para orientado a caracteres largos se for uma operação de E/S para caracteres largos).

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

Quando mode é diferente de zero, a função fwide primeiro tenta setar a orientação do fluxo (para orientado a caractere largo se mode > 0, ou para orientado a byte se mode < 0). Ela retorna um valor denotando a orientação corrente, como visto acima.

VALORES RETORNADOS
A função fwide retorna a orientação do fluxo, depois de possivelmente mudá-la. Um valor de retorno > 0 significa orientação a caracteres largos. Um valor de retorno < 0 significa orientação a byte. Um valor de retorno significa indecisão.

DE ACORDO COM
ISO/ANSI C, UNIX98.

VEJA TAMBÉM
fprintf(3), fwprintf(3).

NOTAS
Saída de caracteres largos para um fluxo orientado a byte pode ser realizado através da função fprintf 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 com as diretivas %c e %s.

TRADUZIDO POR LDP-BR em 21/08/2000.

  Tradução:
Rubens de Jesus Nogueira <darkseid99@usa.net>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>