KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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}

Bronnen