CKTIS / C++
std::format: typované formátování do nového řetězce
std::format vytvoří nový std::string z kontrolovaného formátovacího vzoru a jeho argumentů.
Verze: C++23
Syntaxe
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> vrací nový std::string s reprezentacemi argumentů v nahrazovacích polích; širokoznaková varianta vrací std::wstring a další přetížení přijímají std::locale. V C++23 běžné volání používá format_string<Args...>, jehož literál se při překladu kontroluje proti počtu a typům argumentů.
Příklad formátuje 7 jako 0007, 3.5 se dvěma desetinnými místy a zdvojené složené závorky jako doslovný text, takže vypíše 0007 3.50 {ok}. {} vybírá další argument a část za : řídí například zarovnání, šířku, přesnost a typ prezentace. std::format vrací samostatný řetězec; std::format_to zapisuje přes výstupní iterátor.
Doslovné závorky pište {{ a }}; automatické {} a ruční {0} číslování se nesmí míchat. Neplatný literál nebo typově nekompatibilní specifikátor obvykle zneplatní volání už při překladu. Pro vzor známý až za běhu použijte std::vformat. Také std::format může vyvolat std::format_error pro chybu závislou na hodnotě zjištěnou za běhu, například neplatnou dynamickou šířku či přesnost; výjimky operací formatteru se šíří a alokace může vyvolat std::bad_alloc. Vlastní typ vyžaduje platnou specializaci std::formatter; regionální formátování používá přetížení se std::locale a příslušné volby.
Příklady
#include <format>
#include <iostream>
int main() {
std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}
Výsledek
0007 3.50 {ok}std::format → 0007 3.50 {ok}