fputwc

Autres langues

Langue: es

Version: 25 julio 1999 (fedora - 25/11/07)

Section: 3 (Bibliothèques de fonctions)

NOMBRE

fputwc - escribe un carácter ancho en un flujo FILE

SINOPSIS

 #include <stdio.h>
 
#include <wchar.h> wint_t fputwc (wchar_t wc, FILE* stream); wint_t putwc (wchar_t wc, FILE* stream);

DESCRIPCIÓN

La función fputwc es equivalente para caracteres anchos a la función fputc. La función escribe el carácter ancho wc en stream. Si ferror(stream) es cierto, devuelve WEOF. Si se produce un error en la conversión de caracteres anchos, asigna a errno el valor EILSEQ y devuelve WEOF. En otro caso, devuelve wc.

La función o macro putwc funciona de la misma forma que fputwc. Se puede implementar como una macro y puede evaluar su argumento más de una vez. Nunca hay razón para utilizarla.

VALOR DEVUELTO

La función fputwc devuelve wc si no se ha producido ningún error, o WEOF para indicar un error.

ERRORES

Aparte de los usuales, existe
EILSEQ
Ha fallado la conversión de wc a la codificación del flujo.

CONFORME A

ISO/ANSI C, UNIX98

VÉASE TAMBIÉN

fgetwc(3), fputws(3)

OBSERVACIONES

El comportamiento de fputwc depende de la categoría LC_CTYPE de la localización actual.

En ausencia de información adicional pasada a la llamada fopen, es razonable esperar que fputwc escriba realmente la secuencia multibyte correspondiente al carácter ancho wc.