putc, putwc
Escribe un carácter en un flujo.
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
Parámetros
c
Carácter que se va a escribir.stream
Puntero a la estructura FILE.
Valor devuelto
Devuelve el carácter escrito. Para indicar un error o una condición de final de archivo, putc y putchar devuelven EOF; putwc y putwchar devuelven WEOF. Para las cuatro rutinas, use ferror o feof para comprobar si hay un error o una condición de final de archivo. Si se pasa un puntero nulo para stream, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, estas funciones devuelven EOF o WEOF 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
La rutina putc escribe el carácter individual c en la salida stream en la posición actual. Se puede pasar cualquier entero a putc, pero solo se escriben los 8 bits inferiores. La rutina putchar es idéntica a putc( c**,** stdout ). Para cada rutina, si se produce un error de lectura, se establece el indicador de error para el flujo. putc y putchar se parecen a fputc y _fputchar, respectivamente, pero se implementan como funciones y como macros (vea Elegir entre funciones y macros). putwc y putwchar son versiones con caracteres anchos de putc y putchar, respectivamente. putwc y putc se comportan exactamente igual si el flujo se abre en modo ANSI. putc no admite actualmente la salida en un flujo UNICODE.
Las versiones con el sufijo de _nolock son idénticas, salvo que no están protegidas contra interferencias de otros subprocesos. Para obtener más información, vea _putc_nolock, _putwc_nolock.
Asignaciones de rutina de texto genérico
Rutina TCHAR.H |
_UNICODE y _MBCS no definidos |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_puttc |
putc |
putc |
putwc |
Requisitos
Rutina |
Encabezado necesario |
---|---|
putc |
<stdio.h> |
putwc |
<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.
Bibliotecas
Todas las versiones de las bibliotecas en tiempo de ejecución de C.
Ejemplo
// crt_putc.c
/* This program uses putc to write buffer
* to a stream. If an error occurs, the program
* stops before writing the entire buffer.
*/
#include <stdio.h>
int main( void )
{
FILE *stream;
char *p, buffer[] = "This is the line of output\n";
int ch;
ch = 0;
/* Make standard out the stream and write to it. */
stream = stdout;
for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
ch = putc( *p, stream );
}
Resultados
This is the line of output