puts, _putws
Escribe una cadena en stdout.
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, estas funciones establecen errno en EINVAL y devuelven EOF o WEOF.
Para obtener información sobre estos y otros códigos de error, vea _doserrno, errno, _sys_errlist y _sys_nerr.
Comentarios
La función puts escribe str en el flujo de salida estándar stdout, reemplazando el carácter nulo de terminación de cadena ('\0') con un carácter de línea nueva ('\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.
En Windows 2000 y versiones posteriores, _putwch escribe caracteres Unicode mediante la configuración regional actual de la consola.
Asignaciones de rutina de texto genérico
Rutina TCHAR.H |
_UNICODE y _MBCS no definidos |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_putts |
puts |
puts |
_putws |
Requisitos
Rutina |
Encabezado necesario |
---|---|
puts |
<stdio.h> |
_putws |
<stdio.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_puts.c
/* This program uses puts to write a string to stdout.
*/
#include <stdio.h>
int main( void )
{
puts( "Hello world from puts!" );
}
Resultados
Hello world from puts!