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 produce un error, devuelve EOF; si _putws 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 errno EINVAL 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!" );
}
Output
Hello world from puts!