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.