Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

puts — zápis textu s novým řádkem

Funkce puts z <stdio.h> zapíše řetězec do stdout, přidá nový řádek a vrátí výsledek, který udává, zda zápis uspěl, nebo došlo k chybě.

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

Syntaxe

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

puts(s) zapíše řetězec do stdout a přidá \n. Ukončovací \0 se nevypisuje. Argument musí ukazovat na platný řetězec ukončený nulovým znakem; NULL není povolen.

Funkce neinterpretuje formátovací specifikátory. Pokud řetězec už končí znakem \n, vznikne další prázdný řádek. Na rozdíl od puts umožňuje fputs zvolit proud a nepřidává nový řádek.

Při chybě zápisu je výsledkem EOF, jinak nezáporná hodnota — nemusí jít o počet znaků. Vyrovnávací paměť může odhalení chyby zpozdit; příklad navíc kontroluje fflush(stdout).

Příklady

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

Výsledek

Hello, C!

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje