fputc, fputwc

Escribe un carácter en un flujo.

Sintaxis

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

Para obtener más información sobre los códigos de retorno, vea errno, _doserrno, _sys_errlist y _sys_nerr.

Comentarios

Cada una de estas funciones escribe el carácter c único en un archivo en la posición indicada por el indicador de posición de archivo asociado, si se define. Las funciones avanzan el indicador según corresponda. En fputc y fputwc, el archivo está asociado a stream. Si el archivo no puede admitir solicitudes de posicionamiento o se abrió en modo anexado, el carácter se anexa al final de la secuencia.

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

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

Comentarios específicos de la rutina.

Routine	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. c Escribe como un carácter multibyte o un carácter ancho cuando stream se abre en modo de texto o en modo binario, respectivamente.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas 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 la Plataforma universal de Windows (UWP). Los identificadores de flujo estándar asociados a la consola (stdin, stdout, y stderr) deben redirigirse antes de que las funciones en tiempo de ejecución de C puedan usarlas en aplicaciones para UWP. Para obtener más información sobre compatibilidad, consulte 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 ) ;

}

This is a test of fputc!!

Consulte también

E/S de secuencia
fgetc, fgetwc
putc, putwc