Namespaces
Variants

puts

From cppreference.net
< c ‎ | io
Definido en el encabezado <stdio.h>
int puts ( const char * str ) ;

Escribe cada carácter de la cadena terminada en nulo str y un carácter de nueva línea adicional ' \n ' al flujo de salida stdout , como si se ejecutara repetidamente fputc .

El carácter nulo de terminación de str no se escribe.

Contenidos

Parámetros

str - cadena de caracteres a escribir

Valor de retorno

En caso de éxito, retorna un valor no negativo.

En caso de fallo, devuelve EOF y establece el indicador de error (ver ferror() ) en stream .

Notas

La función puts añade el carácter de nueva línea a la salida, mientras que la función fputs no lo hace.

Diferentes implementaciones retornan diferentes números no negativos: algunas retornan el último carácter escrito, algunas retornan el número de caracteres escritos (o INT_MAX si la cadena era más larga que eso), algunas simplemente retornan una constante no negativa.

Una causa típica de fallo para puts es quedarse sin espacio en el sistema de archivos, cuando stdout está redirigido a un archivo.

Ejemplo

#include <stdio.h>
int main(void)
{
    int rc = puts("Hello World");
    if (rc == EOF)
        perror("puts()"); // POSIX requires that errno is set
}

Salida:

Hello World

Referencias

  • Estándar C23 (ISO/IEC 9899:2024):
  • 7.21.7.9 La función puts (p: TBD)
  • Estándar C17 (ISO/IEC 9899:2018):
  • 7.21.7.9 La función puts (p: TBD)
  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.21.7.9 La función puts (p: 333)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.19.7.10 La función puts (p: 299)
  • Estándar C89/C90 (ISO/IEC 9899:1990):
  • 7.9.7.10 La función puts

Véase también

escribe una cadena de caracteres a un flujo de archivo
(función)
imprime salida formateada a stdout , un flujo de archivo o un búfer
(función)