std::basic_format_arg<Context>::handle

 

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_arg<Context>::handle;		(seit C++20)

Ein typerased Wrapper, der die Formatierung eines Objekts eines benutzerdefinierten Typs ermöglicht.

handle-Objekte werden typischerweise von std::make_format_args erstellt und durch std::visit_format_arg oder die visit-Memberfunktionen von std::basic_format_arg(seit C++26) zugegriffen.

Datenmember

Eine typische Implementierung von handle ist TriviallyCopyable und speichert nur zwei nicht-statische Datenmember:

• ein const void*-Zeiger auf das zu formatierende Objekt, und
• ein void (*)(std::basic_format_parse_context<Context::char_type>&, Context&, const void*)-Funktionszeiger auf die Funktion, die die in der format-Memberfunktion benötigten Operationen durchführt (siehe unten).

Memberfunktionen

format (C++20)

formatiert das referenzierte Objekt mit den gegebenen Kontexten (öffentliche Memberfunktion)

std::basic_format_arg<Context>::handle::format

void format( std::basic_format_parse_context<Context::char_type>& parse_ctx,              Context& format_ctx ) const;		(seit C++20)

Seien

• T sei der Typ des Formatierungsarguments,
• TD sei std::remove_const_t<T>,
• TQ sei const TD, wenn const TD __formattable_with<Context> erfüllt, oder TD andernfalls, und
• ref sei eine Referenz auf das Formatierungsargument.

Äquivalent zu: typename Context::template formatter_type<TD> f;
parse_ctx.advance_to(f.parse(parse_ctx));
format_ctx.advance_to(f.format(const_cast<TQ&>(static_cast<const TD&>(ref)), format_ctx));

Hinweise

Ein handle hat Referenzsemantik für das formatierte Argument und verlängert dessen Lebensdauer nicht. Es liegt in der Verantwortung des Programmierers sicherzustellen, dass das Argument den handle überlebt. Normalerweise wird ein handle nur innerhalb von Formatierungsfunktionen verwendet.

Siehe auch

basic_format_arg (C++20)	Klassentemplate, das den Zugriff auf ein Formatierungsargument für benutzerdefinierte Formatierer ermöglicht (Klassentemplate)
make_format_argsmake_wformat_args (C++20)(C++20)	erstellt ein typ-erased Objekt, das auf alle Formatierungsargumente verweist und in format_args konvertierbar ist (Funktionstemplate)