std::format_error

 

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>
class format_error;		(seit C++20)

Definiert den Typ des Ausnahmeobjekts, das zur Meldung von Fehlern in der Formatierungsbibliothek ausgelöst wird.

Vererbungdiagramm

Memberfunktionen

(Konstruktor)	konstruiert ein neues format_error-Objekt mit der angegebenen Nachricht (öffentliche Memberfunktion)
operator=	ersetzt das format_error-Objekt (öffentliche Memberfunktion)

std::format_error::format_error

format_error( const std::string& what_arg );	(1)
format_error( const char* what_arg );	(2)
format_error( const format_error& other ) noexcept;	(3)

1) Konstruiert das Ausnahmeobjekt mit what_arg als erklärenden String. Nach der Konstruktion gilt std::strcmp(what(), what_arg.c_str()) == 0.

2) Konstruiert das Ausnahmeobjekt mit what_arg als erklärenden String. Nach der Konstruktion gilt std::strcmp(what(), what_arg) == 0.

3) Kopierkonstruktor. Wenn *this und other beide den dynamischen Typ std::format_error haben, dann gilt std::strcmp(what(), other.what()) == 0. Vom Kopierkonstruktor kann keine Ausnahme ausgelöst werden.

Parameter

what_arg	-	erklärende Zeichenkette
Sonstiges	-	ein anderes Ausnahmeobjekt zum Kopieren

Ausnahmen

1,2) Kann std::bad_alloc auslösen.

Anmerkungen

Da das Kopieren von std::format_error keine Ausnahmen auslösen darf, wird diese Nachricht typischerweise intern als separat zugewiesener, referenzgezählter String gespeichert. Dies ist auch der Grund, warum es keinen Konstruktor gibt, der std::string&& annimmt: Der Inhalt müsste ohnehin kopiert werden.

Eine abgeleitete Standard-Ausnahmeklasse muss einen öffentlich zugänglichen Kopierkonstruktor haben. Dieser kann implizit definiert werden, solange die durch what() erhaltenen erklärenden Strings für das Originalobjekt und das kopierte Objekt gleich sind.

std::format_error::operator=

format_error& operator=( const format_error& other ) noexcept;

Weist den Inhalt des Objekts dem von other zu. Wenn *this und other beide den dynamischen Typ std::format_error haben, dann gilt std::strcmp(what(), other.what()) == 0 nach der Zuweisung. Vom Kopierzuweisungsoperator kann keine Ausnahme ausgelöst werden.

Parameter

Sonstiges

-

ein anderes Ausnahmeobjekt zum Zuweisen

Rückgabewert

*this

Anmerkungen

Eine abgeleitete Standard-Ausnahmeklasse muss einen öffentlich zugänglichen Kopierzuweisungsoperator haben. Dieser kann implizit definiert werden, solange die durch what() erhaltenen erklärenden Strings für das Originalobjekt und das kopierte Objekt gleich sind.

Geerbt von std::runtime_error

Abgeleitet von std::exception

Memberfunktionen

(Destruktor) [virtuell]	zerstört das Ausnahmeobjekt (virtuelle öffentliche Memberfunktion von std::exception)
what [virtuell]	gibt einen erklärenden String zurück (virtuelle öffentliche Memberfunktion von std::exception)

Beispiel

Führen Sie diesen Code aus

#include <format>
#include <print>
#include <string_view>
#include <utility>
 
int main()
{
    try
    {
        auto x13{37};
        auto args{std::make_format_args(x13)};
        std::ignore = std::vformat("{:()}", args); // throws
    }
    catch(const std::format_error& ex)
    {
        std::println("{}", ex.what());
    }
}

Mögliche Ausgabe

format error: failed to parse format-spec