puts, _putws

Escribe una cadena en stdout.

Sintaxis

int puts(
   const char *str
);
int _putws(
   const wchar_t *str
);

Parámetros

str
Cadena de salida

Valor devuelto

Devuelve un valor no negativo si se ejecuta correctamente. Si puts se produce un error, devuelve EOF; si _putws se produce un error, devuelve WEOF. Si str es un puntero nulo, 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, las funciones establecidas errnoEINVAL en y devuelven EOF o WEOF.

Para información sobre estos y otros códigos de error, consulte errno, _doserrno_sys_errlist y _sys_nerr.

Comentarios

La puts función escribe str en el flujo stdoutde salida estándar , reemplazando el carácter NULO de terminación de la cadena ('\0') por un carácter de nueva línea ('\n') en el flujo de salida.

_putws es la versión de caracteres anchos de puts. Las dos funciones se comportan exactamente igual si el flujo se abre en modo ANSI. puts no admite actualmente la salida en un flujo UNICODE.

_putwch escribe caracteres Unicode mediante la configuración REGIONALE de CONSOLA actual.

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
_putts	puts	puts	_putws

Requisitos

Routine	Encabezado necesario
puts	<stdio.h>
_putws	<stdio.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.

Bibliotecas

Todas las versiones de las bibliotecas en tiempo de ejecución de C.

Ejemplo

// crt_puts.c
// This program uses puts to write a string to stdout.

#include <stdio.h>

int main( void )
{
   puts( "Hello world from puts!" );
}

Salida

Hello world from puts!

Consulte también

E/S de secuencia
fputs, fputws
fgets, fgetws