WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen