CKTIS / C++
std::format: typované formátovanie do nového reťazca
std::format vytvorí nový std::string z kontrolovaného formátovacieho vzoru a jeho argumentov.
Verzia: C++23
Syntax
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> vracia nový std::string s reprezentáciami argumentov v nahradzovacích poliach; širokoznaková varianta vracia std::wstring a ďalšie preťaženia prijímajú std::locale. V C++23 bežné volanie používa format_string<Args...>, ktorého literál sa pri preklade kontroluje voči počtu a typom argumentov.
Príklad formátuje 7 ako 0007, 3.5 s dvoma desatinnými miestami a zdvojené zložené zátvorky ako doslovný text, takže vypíše 0007 3.50 {ok}. {} vyberá ďalší argument a časť za : riadi napríklad zarovnanie, šírku, presnosť a typ prezentácie. std::format vracia samostatný reťazec; std::format_to zapisuje cez výstupný iterátor.
Doslovné zátvorky píšte {{ a }}; automatické {} a ručné {0} číslovanie sa nesmie miešať. Neplatný literál alebo typovo nekompatibilný špecifikátor zvyčajne zneplatní volanie už pri preklade. Pre vzor známy až za behu použite std::vformat. Aj std::format môže vyvolať std::format_error pre chybu závislú od hodnoty zistenú za behu, napríklad neplatnú dynamickú šírku či presnosť; výnimky operácií formattera sa šíria a alokácia môže vyvolať std::bad_alloc. Vlastný typ vyžaduje platnú špecializáciu std::formatter; regionálne formátovanie používa preťaženie so std::locale a príslušné voľby.
Príklady
#include <format>
#include <iostream>
int main() {
std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}
Výsledok
0007 3.50 {ok}std::format → 0007 3.50 {ok}