putc, putwcputc, putwc

Escribe un carácter en un flujo.Writes a character to a stream.

SintaxisSyntax

int putc(
   int c,
   FILE *stream
);
wint_t putwc(
   wchar_t c,
   FILE *stream
);

ParámetrosParameters

unidadc
Carácter que se va a escribir.Character to be written.

misionesstream
Puntero a la estructura FILE.Pointer to FILE structure.

Valor devueltoReturn Value

Devuelve el carácter escrito.Returns the character written. Para indicar un error o una condición de fin de archivo, putc y putchar devuelven EOF; putwc y putwchar devuelven WEOF.To indicate an error or end-of-file condition, putc and putchar return EOF; putwc and putwchar return WEOF. Para las cuatro rutinas, use ferror o feof para comprobar si hay un error o una condición de final de archivo.For all four routines, use ferror or feof to check for an error or end of file. Si se pasa un puntero nulo para la secuencia, se invoca el controlador de parámetros no válidos, tal y como se describe en validación de parámetros.If passed a null pointer for stream, the invalid parameter handler is invoked, as described in Parameter Validation. Si la ejecución puede continuar, estas funciones devuelven EOF o WEOF y establecen errno en EINVAL.If execution is allowed to continue, these functions return EOF or WEOF and set errno to EINVAL.

Consulte _doserrno, errno, _sys_errlist y _sys_nerr para obtener más información sobre estos y otros códigos de error.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

ObservacionesRemarks

La rutina putc escribe el carácter c único en el flujo de salida en la posición actual.The putc routine writes the single character c to the output stream at the current position. Cualquier entero se puede pasar a putc, pero solo se escriben los 8 bits inferiores.Any integer can be passed to putc, but only the lower 8 bits are written. La rutina putchar es idéntica a putc( c, stdout ).The putchar routine is identical to putc( c, stdout ). Para cada rutina, si se produce un error de lectura, se establece el indicador de error para el flujo.For each routine, if a read error occurs, the error indicator for the stream is set. putc y putchar son similares a fputc y _fputchar, respectivamente, pero se implementan como funciones y como macros (vea elegir entre funciones y macros).putc and putchar are similar to fputc and _fputchar, respectively, but are implemented both as functions and as macros (see Choosing Between Functions and Macros). putwc y putwchar son versiones de caracteres anchos de putc y putchar, respectivamente.putwc and putwchar are wide-character versions of putc and putchar, respectively. putwc y putc se comportan exactamente igual si la secuencia se abre en modo ANSI.putwc and putc behave identically if the stream is opened in ANSI mode. putc no admite actualmente la salida en un flujo Unicode.putc doesn't currently support output into a UNICODE stream.

Las versiones que tienen el sufijo _nolock son idénticas, salvo que no están protegidas contra las interferencias de otros subprocesos.The versions with the _nolock suffix are identical except that they are not protected from interference by other threads. Para obtener más información, vea _putc_nolock, _putwc_nolock.For more information, see _putc_nolock, _putwc_nolock.

De forma predeterminada, el ámbito de este estado global de esta función es la aplicación.By default, this function's global state is scoped to the application. Para cambiar esto, vea estado global en CRT.To change this, see Global state in the CRT.

Asignaciones de rutina de texto genéricoGeneric-Text Routine Mappings

Rutina TCHAR.HTCHAR.H routine _UNICODE y _MBCS no definidos_UNICODE & _MBCS not defined _MBCS definido_MBCS defined _UNICODE definido_UNICODE defined
_puttc_puttc putcputc putcputc putwcputwc

RequisitosRequirements

RutinaRoutine Encabezado necesarioRequired header
putcputc <stdio.h><stdio.h>
putwcputwc <stdio.h> o <wchar.h><stdio.h> or <wchar.h>

La consola no se admite en aplicaciones de Plataforma universal de Windows (UWP).The console is not supported in Universal Windows Platform (UWP) apps. Los identificadores de flujo estándar que están asociados a la consola, stdin, stdouty stderrdeben redirigirse antes de que las funciones en tiempo de ejecución de C puedan usarlos en aplicaciones para UWP.The standard stream handles that are associated with the console, stdin, stdout, and stderr, must be redirected before C run-time functions can use them in UWP apps. Para obtener información adicional sobre compatibilidad, consulte Compatibilidad.For additional compatibility information, see Compatibility.

BibliotecasLibraries

Todas las versiones de las bibliotecas en tiempo de ejecución de C.All versions of the C run-time libraries.

EjemploExample

// 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 );
}

SalidaOutput

This is the line of output

Vea tambiénSee also

E/S de secuenciaStream I/O
fputc, fputwcfputc, fputwc
getc, getwcgetc, getwc