Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::format: typowane formatowanie do nowego napisu

std::format tworzy nowy std::string według sprawdzanego wzorca formatowania i przekazanych argumentów.

Wersja: C++23

Składnia

template<class... Args>
std::string std::format(std::format_string<Args...> fmt, Args&&... args);

template<class... Args>
std::wstring std::format(std::wformat_string<Args...> fmt, Args&&... args);

template<class... Args>
std::string std::format(const std::locale& loc,
    std::format_string<Args...> fmt, Args&&... args);

template<class... Args>
std::wstring std::format(const std::locale& loc,
    std::wformat_string<Args...> fmt, Args&&... args);

std::format(fmt, args...) z <format> zwraca nowy std::string z reprezentacjami argumentów umieszczonymi w polach wzorca; odpowiednik szerokoznakowy zwraca std::wstring, a osobne przeciążenia przyjmują std::locale. W C++23 zwykłe wywołanie używa format_string<Args...>, którego literał jest sprawdzany podczas kompilacji względem liczby i typów argumentów.

Przykład formatuje 7 jako czterocyfrowe 0007, liczbę 3.5 z dwiema cyframi po przecinku oraz podwójne klamry jako tekst dosłowny, drukując 0007 3.50 {ok}. {} wybiera następny argument, a część po : steruje między innymi wyrównaniem, szerokością, precyzją i typem prezentacji. std::format zwraca osobny napis; do dopisywania przez iterator służy std::format_to.

Dosłowne klamry zapisuje się jako {{ i }}; nie wolno mieszać automatycznego numerowania {} z ręcznym {0}. Błędny literał lub niezgodny specyfikator zwykle czyni wywołanie źle zbudowanym już podczas kompilacji. Wzorce znane dopiero w czasie działania obsługuje std::vformat. Także std::format może zgłosić std::format_error dla błędu zależnego od wartości wykrywanego podczas wykonania, np. niepoprawnej dynamicznej szerokości lub precyzji; wyjątki operacji formattera są propagowane, a alokacja może zgłosić std::bad_alloc. Własny typ wymaga poprawnej specjalizacji std::formatter, a ustawienia regionalne działają przez przeciążenie z std::locale i odpowiednie opcje formatu.

Przykłady

#include <format>
#include <iostream>

int main() {
    std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}

Wynik

0007 3.50 {ok}

std::format → 0007 3.50 {ok}

Źródła