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}