std::formatter<Bereich>

 

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)

 

std::formatter<Bereich>

Spezialisierungen von range-default-formatter

range-default-formatter<std::range_format::sequence>

range-default-formatter<std::range_format::map>

range-default-formatter<std::range_format::set>

range-default-formatter<std::range_format::string> range-default-formatter<std::range_format::debug_string>

 

Definiert in Header <format>
template< ranges::input_range R, class CharT >     requires (std::format_kind<R> != std::range_format::disabled) &&               std::formattable<ranges::range_reference_t<R>, CharT> struct formatter<R, CharT>;		(seit C++23)
Hilfsschablonen
template< std::range_format K, ranges::input_range R, class CharT > struct /*range-default-formatter*/;		(nur Exposition*)

Die Template-Spezialisierung von std::formatter für Bereichstypen ermöglicht es Benutzern, einen Bereich in seine textuelle Darstellung als Sammlung von Elementen oder als Zeichenkette unter Verwendung von Formatierungsfunktionen zu konvertieren.

Die Spezialisierung leitet sich von range-default-formatter<std::format_kind<R>, R, CharT> ab.

Die Spezialisierung ist aktiviert, wenn R input_range erfüllt, std::format_kind<R> nicht std::range_format::disabled ist und std::formattable<ranges::range_reference_t<R>, CharT> true ist.

Diese Spezialisierung erfüllt die Anforderungen von Formatter, wenn const R input_range modelliert und ranges::range_reference_t<const R> std::formattable<CharT> modelliert. Sie erfüllt immer die Anforderungen von BasicFormatter.

Format-Spezifikation

Die Syntax von range-format-spec ist

range-fill-and-align (optional) width (optional) n(optional) range-type (optional) range-underlying-spec (optional)

Die Syntax ist vollständig in Bereichs-Format-Spezifikation beschrieben.

Für Spezialisierungen von std::formatter, bei denen std::format_kind<R> entweder std::range_format::string oder std::range_format::debug_string ist, ist die format-spec stattdessen std-format-spec (die std::formatter<std::basic_string<CharT>, CharT> als zugrundeliegender Formatter verwendet) anstelle von range-format-spec.

Spezialisierungen von range-default-formatter

range-default-formatter<std::range_format::sequence> (C++23)	Formatierungsdienstprogramm für Bereiche in Sequenzform (Klassenvorlagenspezialisierung)
range-default-formatter<std::range_format::map> (C++23)	Formatierungsdienstprogramm für Bereiche in Kartenform (Klassenvorlagenspezialisierung)
range-default-formatter<std::range_format::set> (C++23)	Formatierungsdienstprogramm für Bereiche in Mengenform (Klassenvorlagenspezialisierung)
range-default-formatter<std::range_format::string>range-default-formatter<std::range_format::debug_string> (C++23)	Formatierungsdienstprogramm für Bereiche in Zeichenketten- oder escaped Zeichenkettenform (Klassenvorlagenspezialisierung)

Siehe auch

formatter (C++20)	definiert Formatierungsregeln für einen gegebenen Typ (Klassentemplate)
range_formatter (C++23)	Klassentemplate, das bei der Implementierung von std::formatter-Spezialisierungen für Range-Typen hilft (Klassentemplate)