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)

GNU                                          17 de novembro de 1999                                     FWIDE(3)