Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

puts — wypisywanie tekstu z końcem wiersza

Funkcja puts z <stdio.h> zapisuje łańcuch do stdout, dodaje znak nowego wiersza i zwraca wynik informujący o powodzeniu lub błędzie.

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

Składnia

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

puts(s) zapisuje łańcuch do stdout i dodaje \n. Końcowy znak \0 nie jest wypisywany. Argument musi wskazywać poprawny łańcuch zakończony \0; NULL jest niedozwolony.

Funkcja nie interpretuje specyfikatorów formatu. Istniejący końcowy \n spowoduje dodatkowy pusty wiersz. W przeciwieństwie do puts, fputs pozwala wybrać strumień i nie dodaje nowego wiersza.

Wynik to EOF przy błędzie zapisu, a w przeciwnym razie wartość nieujemna — niekoniecznie liczba znaków. Buforowanie może opóźnić wykrycie błędu; przykład sprawdza również fflush(stdout).

Przykłady

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

Wynik

Hello, C!

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła