KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::vformat — formatteren met een tijdens runtime bepaalde formatteertekenreeks

std::vformat uit <format> maakt een tekenreeks op basis van een formatteertekenreeks en een argumentenpakket van het type std::format_args. Het accepteert een patroon dat tijdens runtime wordt bepaald en meldt ongeldige opmaak voor de opgegeven argumenten met std::format_error.

Versie: C++23; repository compiler flag, production runtime not attested

Syntax

#include <format>
std::string std::vformat(std::string_view fmt, std::format_args args);
std::wstring std::vformat(std::wstring_view fmt, std::wformat_args args);
std::string std::vformat(const std::locale& loc, std::string_view fmt, std::format_args args);
std::wstring std::vformat(const std::locale& loc, std::wstring_view fmt, std::wformat_args args);

std::vformat retourneert een nieuwe tekenreeks in plaats van naar een stream te schrijven. Het accepteert een formatteertekenreeks en een argumentenpakket waarvan de typen zijn uitgewist. De overload met std::string_view retourneert std::string; de overload met std::wstring_view gebruikt std::wformat_args en retourneert std::wstring. Overloads met std::locale ondersteunen locale-afhankelijke opmaak.

In C++23 controleert std::format de formatteertekenreeks doorgaans tijdens het compileren. std::vformat accepteert daarentegen een patroon dat pas tijdens runtime beschikbaar is. Ongeldige syntaxis, een ontbrekend aangehaald argument of een specificatie die niet bij het argumenttype past, veroorzaakt std::format_error. Ook uitzonderingen uit formatters en fouten bij geheugentoewijzing kunnen uit de aanroep naar buiten komen.

Maak het pakket met std::make_format_args en benoemde variabelen. Beschouw het niet alsof het eigenaar is van alle waarden: het kan verwijzingen naar argumentgegevens bewaren. Die gegevens moeten geldig blijven totdat het formatteren is voltooid, en std::format_args verlengt zelf de levensduur van de opslag die door std::make_format_args is gemaakt niet. Door die opslag, zoals in het voorbeeld, rechtstreeks aan de aanroep door te geven, wordt voortijdige vernietiging voorkomen.

In het voorbeeld voegt {} label in, terwijl {:04d} count decimaal schrijft met een minimale breedte van vier tekens en voorloopnullen. De uitvoer is item: 0007, gevolgd door een newline. Dit artikel richt zich op C++23; de opgegeven verwijzing leidt naar een evoluerend werkdocument dat latere wijzigingen kan bevatten. Een compileroptie in een repository bewijst niet dat de bibliotheek in de productieomgeving beschikbaar is.

Voorbeelden

#include <format>
#include <iostream>
#include <string>

int main() {
    std::string pattern = "{}: {:04d}";
    std::string label = "item";
    int count = 7;

    std::string result = std::vformat(
        pattern, std::make_format_args(label, count));
    std::cout << result << '\n';
}

Resultaat

item: 0007

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen