1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59
|
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" References consulted:
.\" GNU glibc-2 source code and manual
.\" Dinkumware C library reference http://www.dinkumware.com/
.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
.\" ISO/IEC 9899:1999
.\"
.\" Translated Mon Apr 24 2000 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH FWIDE 3 "17 noviembre 1999" "GNU" "Manual del Programador de Linux"
.SH NOMBRE
fwide \- establece y determina la orientación de un flujo FILE
.SH SINOPSIS
.nf
.B #include <wchar.h>
.sp
.BI "int fwide (FILE* " stream ", int " mode );
.fi
.SH DESCRIPCIÓN
Cuando \fImode\fP es cero, la función \fBfwide\fP determina la orientación
actual de \fIstream\fP. La función devuelve un valor > 0 si \fIstream\fP
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 \fIstream\fP 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 \fIstream\fP 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).
.PP
Una vez que un flujo tiene una orientación, no se puede cambiar y dura hasta
que se cierra el flujo.
.PP
Cuando \fImode\fP no es cero, la función \fBfwide\fP intenta primero
establecer la orientación de \fIstream\fP (a caracteres anchos si
\fImode\fP > 0 o a bytes si \fImode\fP < 0). A continuación devuelve un
valor denotando la orientación actual, como antes.
.SH "VALOR DEVUELTO"
La función \fBfwide\fP 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.
.SH "CONFORME A"
ISO/ANSI C, UNIX98
.SH "VÉASE TAMBIÉN"
.BR fprintf "(3), " fwprintf (3)
.SH OBSERVACIONES
Se puede realizar una salida de caracteres anchos a un flujo orientado a
bytes a través de la función \fBfprintf\fP con las directivas %lc y %ls.
.PP
Se puede realizar una salida orientada a caracteres a un flujo orientado a
caracteres anchos a través de la función \fBfwprintf\fP con las directivas
%c y %s.
|