Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

puts — scrivere testo con una nuova riga

La funzione puts di <stdio.h> scrive una stringa su stdout, aggiunge una nuova riga e restituisce un risultato che indica se l’operazione è riuscita o se si è verificato un errore.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

#include <stdio.h>
int puts(const char *s);

puts(s) scrive una stringa su stdout e aggiunge \n. Il \0 finale non viene scritto. L’argomento deve puntare a una stringa valida terminata da un carattere nullo; NULL non è consentito.

La funzione non interpreta gli specificatori di formato. Se la stringa termina già con \n, viene prodotta un’ulteriore riga vuota. A differenza di puts, fputs consente di scegliere il flusso e non aggiunge una nuova riga.

Il risultato è EOF in caso di errore di scrittura; altrimenti è un valore non negativo, che non corrisponde necessariamente al numero di caratteri. Il buffering può ritardare il rilevamento degli errori; l’esempio controlla anche fflush(stdout).

Esempi

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    if (puts("Hello, C!") == EOF) {
        return EXIT_FAILURE;
    }
    if (fflush(stdout) == EOF) {
        return EXIT_FAILURE;
    }
    return EXIT_SUCCESS;
}

Risultato

Hello, C!

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti