CKTIS / C++
std::format: tipizirano formatiranje u novi niz
std::format stvara novi std::string iz provjerenog formatnog uzorka i argumenata.
Verzija: 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> vraća novi std::string s prikazima argumenata u zamjenskim poljima; širokoznakovna inačica vraća std::wstring, a dodatna preopterećenja primaju std::locale. U C++23 običan poziv koristi format_string<Args...>, čiji se literal pri prevođenju provjerava prema broju i tipovima argumenata.
Primjer formatira 7 kao 0007, 3.5 s dvije decimalne znamenke i udvostručene vitičaste zagrade kao doslovan tekst te ispisuje 0007 3.50 {ok}. {} bira sljedeći argument, a dio iza : upravlja poravnanjem, širinom, preciznošću i vrstom prikaza. std::format vraća zaseban niz; std::format_to piše kroz izlazni iterator.
Doslovne zagrade pišu se {{ i }}; automatsko {} i ručno {0} numeriranje ne smiju se miješati. Nevaljan literal ili tipski nekompatibilan specifikator obično čini poziv neispravnim već pri prevođenju. Za uzorak poznat tek tijekom izvođenja koristi std::vformat. I std::format može baciti std::format_error za pogrešku ovisnu o vrijednosti otkrivenu tijekom izvođenja, primjerice nevaljanu dinamičku širinu ili preciznost; iznimke operacija formattera propagiraju se, a alokacija može baciti std::bad_alloc. Vlastiti tip zahtijeva valjanu specijalizaciju std::formatter; regionalno formatiranje koristi preopterećenje std::locale i odgovarajuće opcije.
Primjeri
#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}