NOMBRE

       fwide - establece y determina la orientación de un flujo FILE

SINOPSIS

       #include <wchar.h>

       int fwide (FILE* stream, int mode);

DESCRIPCIÓN

       Cuando  mode  es  cero,  la  función  fwide  determina la orientación actual de stream. La
       función devuelve un valor > 0 si stream está orientado a caracteres anchos, es  decir,  si
       se  permite  la E/S de caracteres anchos pero se prohibe la E/S de caracteres. Devuelve un
       valor < 0 si stream está orientado a bytes, o sea, si se permite la E/S de caracteres pero
       se  prohibe  la  E/S  de  caracteres  anchos.  Devuelve  cero  si  stream todavía no tiene
       orientación. En este caso, la próxima operación de E/S podría cambiar  la  orientación  (a
       bytes  si  es una operación de E/S de caracteres o a caracteres anchos si es una operación
       de E/S de caracteres anchos).

       Una vez que un flujo tiene una orientación, no se puede cambiar y dura hasta que se cierra
       el flujo.

       Cuando  mode  no  es  cero,  la función fwide intenta primero establecer la orientación de
       stream (a caracteres anchos si mode > 0 o a bytes si mode < 0). A continuación devuelve un
       valor denotando la orientación actual, como antes.

VALOR DEVUELTO

       La función fwide devuelve la orientación del flujo, posiblemente después de cambiarlo. Una
       valor devuelto > 0 significa  orientado  a  caracteres  anchos.  Un  valor  devuelto  <  0
       significa orientado a bytes. Un valor devuelto cero significa indefinido.

CONFORME A

       ISO/ANSI C, UNIX98

VÉASE TAMBIÉN

       fprintf(3), fwprintf(3)

OBSERVACIONES

       Se puede realizar una salida de caracteres anchos a un flujo orientado a bytes a través de
       la función fprintf con las directivas %lc y %ls.

       Se puede realizar una salida orientada a caracteres a  un  flujo  orientado  a  caracteres
       anchos a través de la función fwprintf con las directivas %c y %s.