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