Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::println — formatowane wyjście zakończone nową linią

std::println z nagłówka <print> formatuje argumenty, zapisuje wynik i dodaje znak nowej linii. Domyślnie używa stdout; przeciążenie przyjmujące FILE* pozwala wskazać inny strumień wyjściowy.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#include <print>
std::println("format", args...);
std::println(stream, "format", args...);

std::println to funkcja biblioteki standardowej C++23, deklarowana w <print>. Wywołanie std::println("format", args...) zapisuje sformatowany tekst do stdout i dodaje \n. Zwraca void. W odróżnieniu od std::print automatycznie kończy tekst nową linią; nie oznacza to jednak gwarancji opróżnienia bufora przy każdym wywołaniu.

Pola {} pobierają kolejne argumenty. Po dwukropku można podać specyfikację formatu: {:04d} oznacza dziesiętną liczbę całkowitą w polu o minimalnej szerokości czterech znaków, uzupełnianym zerami. W przykładzie 42 daje 0042; większa liczba nie jest obcinana.

Postać std::println(stream, "format", args...) przyjmuje jako pierwszy argument prawidłowy wskaźnik FILE* do strumienia wyjściowego. Błędy zapisu mogą powodować std::system_error, a formatowanie i alokacja również mogą zgłaszać wyjątki.

Wymagany jest kompilator i biblioteka standardowa obsługujące <print>; sama flaga C++23 nie potwierdza dostępności funkcji. Wersja wpisu: C++23; flaga kompilatora w repozytorium, środowisko uruchomieniowe produkcji niepotwierdzone. Podane źródła opisują rozwijany szkic standardu, który może zawierać dodatki późniejsze niż C++23.

Przykłady

#include <print>

int main() {
    std::println("{}: {:04d}", "Score", 42);
}

Wynik

Score: 0042

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

Źródła