fputc, fputwc
Escribe un carácter en una secuencia.
int fputc(
int c,
FILE *stream
);
wint_t fputwc(
wchar_t c,
FILE *stream
);
Parámetros
c
Carácter que se escriba.stream
Puntero a la estructura de FILE.
Valor devuelto
Cada una de estas funciones devuelve el carácter con tipo.Para fputc, un valor devuelto de EOF indica un error.Para fputwc, un valor devuelto de WEOF indica un error.Si stream es NULL, estas funciones se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, devuelven EOF y errno determinado a EINVAL.
Vea _doserrno, errno, _sys_errlist, y _sys_nerr para obtener más información al respecto, y otro, códigos de error.
Comentarios
Cada una de estas funciones escribe el carácter individual c a un archivo en la posición indicada por el marcador de posición de archivo asociado (si está definido) y avances el marcador según corresponda.En el caso de fputc y de fputwc, el archivo se asocia a stream*.* Si el archivo no puede admitir la posición de solicitudes ni se ha abierto en modo Anexar, el carácter se anexa al final de la secuencia.
Las dos funciones se comportan exactamente igual si la secuencia se abre en el modo de ANSI.fputc no admite actualmente la salida en una secuencia de UNICODE.
Las versiones con el sufijo de _nolock son idénticas salvo que no se protegen de interferencia por otros subprocesos.Para obtener más información, vea _fputc_nolock, _fputwc_nolock.
Las notas Rutina-específicas siguen.
Rutina |
Comentarios |
---|---|
fputc |
Equivalente a putc, pero implementado solo como función, en lugar de como una función y macros. |
fputwc |
Versión de caracteres anchos de fputc.Escribe c como un carácter multibyte o carácter ancho como si stream está abierta en modo de texto o modo binario. |
Asignaciones de la rutina de Genérico- texto
Rutina de 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.Los identificadores estándar de la secuencia asociados a la consola, stdin, stdout, y stderr, deben redirigir antes de que las funciones en tiempo de ejecución de C pueden utilizarlos en las aplicaciones de Tienda Windows.Para obtener información adicional de compatibilidad, vea Compatibilidad en la Introducción.
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 ) ;
}