Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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}

Zdroje