putc, putwc
Escriba un carácter en una secuencia.
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
Parámetros
c
Carácter que se escriba.stream
Puntero a la estructura file.
Valor devuelto
Devuelve el carácter con tipo.Para indicar un error o una condición final de archivo, putc y putchar devuelven EOF; putwc y volver WEOF de putwchar.Para que cuatro rutinas, usos ferror o feof comprueben para buscar un error o un final de archivo.Si se pasa un puntero NULL para stream, el controlador no válido de parámetro se invoca, como se describe en Validación de parámetros.Si la ejecución puede continuar, estas funciones EOF return o WEOF 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
La rutina de putc escribe el carácter individual c a la salida stream en la posición actual.Cualquier entero se puede pasar a putc, pero solo se escriben los 8 bits inferiores.La rutina de putchar es idéntica a putc(c,stdout ).Para cada rutina, si un error de lectura, aparece el mensaje de error para la secuencia se establece.putc y putchar son similares a fputc y a _fputchar, respectivamente, pero se implementan como funciones como macros (vea Elegir las funciones y macros de Entre).putwc y putwchar son versiones de caracteres anchos de putc y de putchar, respectivamente.putwc y putc se comportan exactamente igual si la secuencia se abre en el modo de ANSI.putc no admite actualmente la salida en una secuencia de UNICODE.
Las versiones con el sufijo _nolock son idénticas salvo que no se protegen de interferencia por otros subprocesos.Para obtener más información, vea _putc_nolock, _putwc_nolock.
Asignaciones de la rutina de Genérico- texto
Rutina de 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.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.
Bibliotecas
Todas las versiones de 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 );
}
Output
This is the line of output