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
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.