CKTIS / C++
std::vformat — Formatierung mit einer zur Laufzeit bestimmten Formatzeichenfolge
std::vformat aus <format> erstellt aus einer Formatzeichenfolge und einem Argumentpaket vom Typ std::format_args eine Zeichenfolge. Es akzeptiert ein zur Laufzeit bestimmtes Muster und meldet ungültige Formatierungen für die übergebenen Argumente mit std::format_error.
Version: 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 gibt eine neue Zeichenfolge zurück, statt in einen Ausgabestrom zu schreiben. Es akzeptiert eine Formatzeichenfolge und ein Argumentpaket mit gelöschten Typinformationen. Die Überladung mit std::string_view gibt std::string zurück; die Überladung mit std::wstring_view verwendet std::wformat_args und gibt std::wstring zurück. Überladungen mit std::locale unterstützen eine von der Locale abhängige Formatierung.
In C++23 prüft std::format seine Formatzeichenfolge normalerweise zur Compile-Zeit. std::vformat akzeptiert dagegen ein Muster, das erst zur Laufzeit verfügbar ist. Ungültige Syntax, ein fehlendes referenziertes Argument oder ein mit dem Argumenttyp unvereinbarer Spezifizierer lösen std::format_error aus. Auch Ausnahmen aus Formatierern und Speicherallokationsfehler können den Aufruf verlassen.
Erstelle das Paket mit std::make_format_args und benannten Variablen. Behandle es nicht so, als besäße es alle Werte: Es kann Referenzen auf Argumentdaten speichern. Diese Daten müssen bis zum Ende der Formatierung gültig bleiben, und std::format_args selbst verlängert nicht die Lebensdauer des von std::make_format_args erzeugten Speichers. Wird dieser Speicher wie im Beispiel direkt an den Aufruf übergeben, wird seine vorzeitige Zerstörung vermieden.
Im Beispiel fügt {} label ein, während {:04d} count dezimal mit einer Mindestbreite von vier Zeichen und führenden Nullen ausgibt. Die Ausgabe lautet item: 0007, gefolgt von einem Zeilenumbruch. Dieser Eintrag bezieht sich auf C++23; der angegebene Verweis führt zu einem fortlaufend weiterentwickelten Arbeitsentwurf, der spätere Änderungen enthalten kann. Ein Compiler-Flag im Repository belegt nicht, dass die Bibliothek in der Produktionsumgebung verfügbar ist.
Beispiele
#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';
}
Ergebnis
item: 0007
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.