WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::format: typisiertes Formatieren in eine neue Zeichenkette

std::format erzeugt aus geprüftem Formatmuster und Argumenten einen neuen std::string.

Version: 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...) aus <format> liefert einen neuen std::string, in dessen Ersetzungsfeldern die Argumentdarstellungen stehen; die breitzeichenbasierte Variante liefert std::wstring, weitere Overloads akzeptieren std::locale. In C++23 verwendet ein gewöhnlicher Aufruf format_string<Args...>, dessen Literal zur Compilezeit gegen Anzahl und Typen der Argumente geprüft wird.

Das Beispiel formatiert 7 als 0007, 3.5 mit zwei Nachkommastellen und doppelte Klammern als wörtlichen Text; es gibt 0007 3.50 {ok} aus. {} wählt das nächste Argument, der Teil nach : steuert etwa Ausrichtung, Breite, Genauigkeit und Darstellungsart. std::format liefert eine eigene Zeichenkette; std::format_to schreibt über einen Ausgabeiterator.

Wörtliche Klammern schreibt man als {{ und }}; automatische Nummerierung {} und manuelle {0} dürfen nicht gemischt werden. Ein ungültiges Literal oder typswidriger Spezifikator macht den Aufruf normalerweise schon beim Übersetzen ungültig. Für erst zur Laufzeit bekannte Muster dient std::vformat. Auch std::format selbst kann bei einem erst durch Argumentwerte zur Laufzeit erkannten Fehler, etwa ungültiger dynamischer Breite oder Präzision, std::format_error auslösen; Formatter-Ausnahmen werden weitergereicht und Allokation kann std::bad_alloc auslösen. Eigene Typen benötigen eine gültige std::formatter-Spezialisierung; regionale Formatierung nutzt den std::locale-Overload und passende Optionen.

Beispiele

#include <format>
#include <iostream>

int main() {
    std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}

Ergebnis

0007 3.50 {ok}

std::format → 0007 3.50 {ok}

Quellen