CKTIS / C++
std::format: tipizirano oblikovanje v nov niz
std::format ustvari nov std::string iz preverjenega oblikovnega vzorca in argumentov.
Različica: C++23
Sintaksa
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...) iz <format> vrne nov std::string s predstavitvami argumentov v nadomestnih poljih; širokoznakovna različica vrne std::wstring, dodatne preobremenitve pa sprejmejo std::locale. V C++23 običajen klic uporablja format_string<Args...>, katerega literal se med prevajanjem preveri glede na število in tipe argumentov.
Primer oblikuje 7 kot 0007, 3.5 z dvema decimalnima mestoma in podvojene zavite oklepaje kot dobesedno besedilo ter izpiše 0007 3.50 {ok}. {} izbere naslednji argument, del za : pa določa poravnavo, širino, natančnost in vrsto prikaza. std::format vrne ločen niz; std::format_to zapisuje prek izhodnega iteratorja.
Dobesedne oklepaje napišite kot {{ in }}; samodejnega {} in ročnega {0} številčenja ni dovoljeno mešati. Neveljaven literal ali tipsko nezdružljiv določilnik navadno naredi klic neveljaven že med prevajanjem. Za vzorec, znan šele med izvajanjem, uporabite std::vformat. Tudi std::format lahko vrže std::format_error pri napaki, odvisni od vrednosti in odkriti med izvajanjem, na primer neveljavni dinamični širini ali natančnosti; izjeme operacij formatterja se razširijo, dodelitev pa lahko vrže std::bad_alloc. Lastni tip zahteva veljavno specializacijo std::formatter; področno oblikovanje uporablja preobremenitev std::locale in ustrezne možnosti.
Primeri
#include <format>
#include <iostream>
int main() {
std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}
Rezultat
0007 3.50 {ok}std::format → 0007 3.50 {ok}