Provided by: manpages-pt-dev_20040726-4_all bug

NOME

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

SINOPSE

       #include <wchar.h>

       int fwide (FILE* stream, int mode);

DESCRIÇÃO

       Quando  mode  é zero, a função fwide determina a orientação corrente de
       stream. Ela retorna um valor > 0 se stream  é  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  stream  é
       orientado  a  byte, isto é, se E/S de caracteres é permitido mas E/S de
       caracteres largos está desabilitado. Ela retorna zero se  stream  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 de stream (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.

VALOR DE RETORNO

       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.

CONFORME

       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.

TRADUÇÃO PARA A LÍNGUA PORTUGUESA

       RUBENS DE JESUS  NOGUEIRA  <darkseid99@usa.net>  (tradução)  XXXXXX  XX
       XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx> (revisão)