CKTIS / C++
std::format: getypeerde opmaak naar een nieuwe tekenreeks
std::format maakt een nieuwe std::string uit een gecontroleerd opmaakpatroon en de argumenten.
Versie: 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...) uit <format> retourneert een nieuwe std::string met argumentrepresentaties in vervangingsvelden; de breedtekenvariant retourneert std::wstring en aparte overloads accepteren std::locale. In C++23 gebruikt een gewone aanroep format_string<Args...>, waarvan het letterlijke patroon tijdens compilatie wordt gecontroleerd tegen aantal en typen argumenten.
Het voorbeeld formatteert 7 als 0007, 3.5 met twee cijfers na de komma en dubbele accolades als letterlijke tekst; het print 0007 3.50 {ok}. {} kiest het volgende argument en het deel na : regelt onder meer uitlijning, breedte, precisie en presentatietype. std::format retourneert een aparte tekenreeks; std::format_to schrijft via een outputiterator.
Schrijf letterlijke accolades als {{ en }}; automatische {} en handmatige {0} nummering mogen niet worden gemengd. Een ongeldig letterlijk patroon of type-incompatibele specificatie maakt de aanroep normaal al tijdens compilatie ongeldig. Gebruik voor een pas tijdens uitvoering bekend patroon std::vformat. Ook std::format zelf kan std::format_error werpen voor een waardeafhankelijke fout die pas tijdens uitvoering blijkt, zoals een ongeldige dynamische breedte of precisie; formatter-excepties worden doorgegeven en allocatie kan std::bad_alloc werpen. Een eigen type vereist een geldige std::formatter-specialisatie; regionale opmaak gebruikt de std::locale-overload en passende opties.
Voorbeelden
#include <format>
#include <iostream>
int main() {
std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}
Resultaat
0007 3.50 {ok}std::format → 0007 3.50 {ok}