std::basic_format_args

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Textkodierungserkennung

text_encoding (C++26)

 

Formatierungsbibliothek

Standardformat-Spezifikation

Formatierungsfunktionen

format (C++20)

format_to (C++20)

format_to_n (C++20)

formatted_size (C++20)

vformat (C++20)

vformat_to (C++20)

Format-Strings

basic_format_stringformat_stringwformat_string (C++20)(C++20)(C++20)

runtime_format (C++26)

Formatierungs-Konzepte

formattable (C++23)

Formatter

formatter (C++20)

formatter<pair-or-tuple> (C++23)

formatter<range> (C++23)

range_formatter (C++23)

enable_nonlocking_formatter_optimization (C++23)

basic_format_parse_contextformat_parse_contextwformat_parse_context (C++20)(C++20)(C++20)

basic_format_contextformat_contextwformat_context (C++20)(C++20)(C++20)

range_format (C++23)

format_kind (C++23)

Formatierungs-Argumente

basic_format_arg (C++20)

basic_format_arg::handle (C++20)

basic_format_argsformat_argswformat_args (C++20)(C++20)(C++20)

visit_format_arg (C++20) (veraltet in C++26)

make_format_argsmake_wformat_args (C++20)(C++20)

Format-Fehler

format_error (C++20)

 

Definiert in Header <format>
template< class Context > class basic_format_args;	(1)	(seit C++20)
using format_args = basic_format_args<std::format_context>;	(2)	(seit C++20)
using wformat_args = basic_format_args<std::wformat_context>;	(3)	(seit C++20)

Bietet Zugriff auf Formatierungsargumente.

Member functions

(Konstruktor)	Konstruiert ein basic_format_args Objekt. (öffentliche Memberfunktion)
get	Gibt das Formatierungsargument am angegebenen Index zurück. (öffentliche Memberfunktion)

std::basic_format_args::basic_format_args

template< class... Args > basic_format_args( const /*format-arg-store*/<Context, Args...>& store ) noexcept;

Konstruiert ein basic_format_args Objekt aus dem Ergebnis eines Aufrufs von std::make_format_args oder std::make_wformat_args.

std::basic_format_args::get

std::basic_format_arg<Context> get( std::size_t i ) const noexcept;

Gibt ein std::basic_format_arg zurück, das das i-te Argument in args enthält, wobei args die an std::make_format_args oder std::make_wformat_args übergebene Parameterliste ist.

Wenn kein solches Formatierungsargument vorhanden ist (d.h. *this wurde default-konstruiert oder i ist nicht kleiner als die Anzahl der Formatierungsargumente), wird ein default-konstruiertes std::basic_format_arg zurückgegeben (das ein std::monostate-Objekt enthält).

Deduktionsleitfäden

template< class Context, class... Args > basic_format_args( /*format-arg-store*/<Context, Args...> ) -> basic_format_args<Context>;		(seit C++20)

Anmerkungen

std::basic_format_args hat Semantik für Referenzen. Es liegt in der Verantwortung des Programmierers sicherzustellen, dass *this nicht länger lebt als store (was wiederum nicht länger leben sollte als die Argumente zu std::make_format_args oder std::make_wformat_args).

Defect reports

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
P2216R3	C++20	format_args_t wurde aufgrund der Überparametrisierung von vformat_to bereitgestellt.	entfernt
LWG 3810	C++20	basic_format_args hat keinen Deduktionsleitfaden.	hinzugefügt
LWG 4106	C++20	basic_format_args war default-konstruierbar.	Default-Konstruktor entfernt.

Siehe auch

basic_format_arg (C++20)

Klassentemplate, das den Zugriff auf ein Formatierungsargument für benutzerdefinierte Formatierer ermöglicht (Klassentemplate)