fputc, fputwc

Artículo
06/09/2015

Escribe un carácter en un flujo.

int fputc(
   int c,
   FILE *stream 
);
wint_t fputwc(
   wchar_t c,
   FILE *stream 
);

Parámetros

c
Carácter que se va a escribir.
stream
Puntero a la estructura FILE.

Valor devuelto

Cada una de estas funciones devuelve el carácter escrito. En el caso de fputc, el valor EOF devuelto indica un error. En el caso de fputwc, el valor WEOF devuelto indica un error. Si stream es NULL, estas funciones invocan el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, devuelven EOF y establecen errno en EINVAL.

Vea _doserrno, errno, _sys_errlist y _sys_nerr para obtener más información sobre estos y otros códigos de error.

Comentarios

Cada una de estas funciones escribe el carácter único c en un archivo, en la posición indicada por el indicador de posición de archivo asociado (si está definido) y hace avanzar el indicador según corresponda. En el caso de fputc y fputwc, el archivo se asocia a stream*.* Si el archivo no admite solicitudes de posición o no se abrió en modo Append, el carácter se anexa al final del flujo.

Las dos funciones se comportan igual si el flujo se abre en modo ANSI. fputc no admite actualmente la salida a un flujo UNICODE.

Las versiones con el sufijo _nolock son idénticas, salvo que no están protegidas contra interferencias de otros subprocesos. Para obtener más información, vea_fputc_nolock, _fputwc_nolock.

Comentarios específicos de la rutina.

Rutina	Comentarios
fputc	Equivale a putc, pero implementado solo como función, y no como una función y una macro.
fputwc	Versión de caracteres anchos de fputc. Escribe c como carácter multibyte o carácter ancho en función de que stream se haya abierto en modo de texto o modo binario.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_fputtc	fputc	fputc	fputwc

Requisitos

Función	Encabezado necesario
fputc	<stdio.h>
fputwc	<stdio.h> o <wchar.h>

La consola no se admite en las aplicaciones de Tienda Windows. Se deben redirigir los identificadores estándar de flujo que están asociados a la consola, stdin, stdout y stderr, antes de que las funciones en tiempo de ejecución de C puedan usarlos en aplicaciones de Tienda Windows. Para obtener más información sobre compatibilidad, vea Compatibilidad.

Ejemplo

// crt_fputc.c
// This program uses fputc
// to send a character array to stdout.
 

#include <stdio.h>

int main( void )
{
   char strptr1[] = "This is a test of fputc!!\n";
   char *p;

   // Print line to stream using fputc. 
   p = strptr1;
   while( (*p != '\0') && fputc( *(p++), stdout ) != EOF ) ;

}