Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

puts — escrever texto com uma mudança de linha

A função puts de <stdio.h> escreve uma cadeia em stdout, acrescenta uma mudança de linha e devolve um resultado que indica se a operação foi bem-sucedida ou se ocorreu um erro.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

puts(s) escreve uma cadeia em stdout e acrescenta \n. O \0 final não é escrito. O argumento tem de apontar para uma cadeia válida terminada em nulo; NULL não é permitido.

A função não interpreta especificadores de formato. Se a cadeia já terminar em \n, é criada uma linha em branco adicional. Ao contrário de puts, fputs permite escolher o fluxo e não acrescenta uma mudança de linha.

O resultado é EOF em caso de erro de escrita; caso contrário, é um valor não negativo, que não corresponde necessariamente ao número de caracteres. O buffering pode atrasar a deteção de erros; o exemplo também verifica fflush(stdout).

Exemplos

#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;
}

Resultado

Hello, C!

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes