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 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.
| 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, se deben redirigir antes de que las funciones en tiempo de ejecución de C puedan usarlos 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!!