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.

GNU                                             17 noviembre 1999                                       FWIDE(3)