std::system_category

 

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

 

Diagnostik-Bibliothek

Ausnahmebehandlung exception uncaught_exceptionuncaught_exceptions (bis C++20*)  (C++17) exception_ptr (C++11) make_exception_ptr (C++11) current_exception (C++11) rethrow_exception (C++11) nested_exception (C++11) throw_with_nested (C++11) rethrow_if_nested (C++11) Exception handling failures terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (bis C++17*) unexpected_handler (bis C++17*) get_unexpected (bis C++17*) set_unexpected (bis C++17*) Fehlernummern Error codes errno Assertions assert

Exception categories logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (TM TS) System error error_category (C++11) generic_category (C++11) system_category (C++11) error_condition (C++11) errc (C++11) error_code (C++11) system_error (C++11) Stacktrace stacktrace_entry (C++23) basic_stacktrace (C++23) Debugging-Unterstützung is_debugger_present (C++26) breakpoint_if_debugging (C++26) breakpoint (C++26)

 

Definiert in der Header-Datei <system_error>
const std::error_category& system_category() noexcept;		(seit C++11)

Gibt eine Referenz auf das statische Fehlerkategorie-Objekt für vom Betriebssystem gemeldete Fehler zurück. Das Objekt muss die virtuelle Funktion std::error_category::name() überschreiben, um einen Zeiger auf den String "system" zurückzugeben. Es muss auch die virtuelle Funktion std::error_category::default_error_condition() überschreiben, um Fehlercodes, die mit POSIX errno-Werten übereinstimmen, auf std::generic_category abzubilden.

Parameter

(keine)

Rückgabewert

Eine Referenz auf das statische Objekt eines nicht spezifizierten Laufzeittyps, abgeleitet von std::error_category.

Hinweise

Unter Windows ordnet system_category() typischerweise einige Windows-Fehlercodes POSIX-Codes zu. Unter POSIX ist system_category() im Allgemeinen äquivalent zu std::generic_category(), abgesehen vom Namen.

Beispiel

Führen Sie diesen Code aus

#include <iomanip>
#include <iostream>
#include <string>
#include <system_error>
 
int main()
{
    for (int const code : {EDOM, 10001})
    {
        const std::error_condition econd =
            std::system_category().default_error_condition(code);
 
        std::cout << "Category: " << econd.category().name() << '\n'
                  << "Value:    " << econd.value() << '\n'
                  << "Message:  " << econd.message() << "\n\n";
    }
}

Mögliche Ausgabe

Category: generic
Value:    33
Message:  Numerical argument out of domain
 
Category: system
Value:    10001
Message:  Unknown error 10001

Siehe auch

generic_category (C++11)	identifiziert die generische Fehlerkategorie (Funktion)
errc (C++11)	die std::error_condition-Aufzählung, die alle Standard-Makrokonstanten aus <cerrno> listet (Klasse)