error_code-Klasse

Stellt Systemfehler auf niedriger Ebene dar, die spezifisch für die Implementierung sind.

Syntax

class error_code;

Hinweise

Ein Objekt vom Typ error_code-Klasse enthält einen Fehlercodewert und einen Zeiger auf ein Objekt, das eine Kategorie von Fehlercodes darstellt, die gemeldete Systemfehler auf niedriger Ebene beschreiben.

Member

Konstruktoren

Name Beschreibung
error_code Konstruiert ein Objekt vom Typ error_code.

TypeDefs

Name Beschreibung
value_type Ein Typ, der den gespeicherten Fehlercodewert darstellt.

Funktionen

Name Beschreibung
assign Weist einen Fehlercodewert und die Kategorie an einen Fehlercode zu.
category Gibt die Fehlerkategorie zurück.
clear Löscht den Fehlercodewert und die Kategorie.
default_error_condition Gibt die Standardfehlerbedingung zurück.
Nachricht Gibt den Namen des Fehlercodes zurück.

Operatoren

Name Beschreibung
operator== Prüft auf Gleichheit zwischen error_code-Objekten.
operator!= Prüft auf Ungleichheit zwischen error_code-Objekten.
operator< Testet, ob das error_code-Objekt kleiner ist als das error_code-Objekt, das für den Vergleich übergeben wurde.
operator= Weist dem error_code-Objekt einen neuen Enumerationswert zu.
operator bool Wandelt eine Variable vom Typ error_code um.

Zuweisen

Weist einen Fehlercodewert und die Kategorie an einen Fehlercode zu.

void assign(value_type val, const error_category& _Cat);

Parameter

val
Der Fehlercodewert, der in error_code gespeichert werden soll.

_Katze
Die Fehlerkategorie, die in error_code gespeichert werden soll.

Hinweise

Die Memberfunktion speichert "val" als Fehlercodewert und als Zeiger auf _Cat.

category

Gibt die Fehlerkategorie zurück.

const error_category& category() const;

Hinweise

clear

Löscht den Fehlercodewert und die Kategorie.

clear();

Hinweise

Die Memberfunktion speichert einen Fehlercodewert „Null“ und einen Zeiger auf das Objekt generic_category.

default_error_condition

Gibt die Standardfehlerbedingung zurück.

error_condition default_error_condition() const;

Rückgabewert

Die von default_error_condition angegebene Funktion error_condition.

Hinweise

Diese Memberfunktion gibt category().default_error_condition(value()) zurück.

error_code

Konstruiert ein Objekt vom Typ error_code.

error_code();

error_code(value_type val, const error_category& _Cat);

template <class _Enum>
error_code(_Enum _Errcode,
    typename enable_if<is_error_code_enum<_Enum>::value,
    error_code>::type* = 0);

Parameter

val
Der Fehlercodewert, der in error_code gespeichert werden soll.

_Katze
Die Fehlerkategorie, die in error_code gespeichert werden soll.

_Errcode
Der Enumerationswert, der in error_code gespeichert werden soll.

Hinweise

Der erste Konstruktor speichert einen Fehlercodewert „Null“ und einen Zeiger auf generic_category.

Der zweite Konstruktor speichert "val" als Fehlercodewert und als Zeiger auf error_category.

Der dritte Konstruktor speichert (value_type)_Errcode als Fehlercodewert und einen Zeiger auf generic_category.

Nachricht

Gibt den Namen des Fehlercodes zurück.

string message() const;

Rückgabewert

Ein string, der den Namen des Fehlercodes darstellt.

Hinweise

Diese Memberfunktion gibt category().message(value()) zurück.

operator==

Prüft auf Gleichheit zwischen error_code-Objekten.

bool operator==(const error_code& right) const;

Parameter

right
Das Objekt, das auf Gleichheit getestet werden soll.

Rückgabewert

true wenn die Objekte gleich sind; false wenn Objekte nicht gleich sind.

Hinweise

Der Memberoperator gibt category() == right.category() && value == right.value()zurück.

operator!=

Prüft auf Ungleichheit zwischen error_code-Objekten.

bool operator!=(const error_code& right) const;

Parameter

right
Das Objekt, das auf Ungleichheit geprüft werden soll.

Rückgabewert

truewenn das error_code Objekt nicht gleich dem Objekt ist, das error_code rechts übergeben wird; andernfalls false.

Hinweise

Der Memberoperator gibt !(*this == right)zurück.

operator<

Testet, ob das error_code-Objekt kleiner ist als das error_code-Objekt, das für den Vergleich übergeben wurde.

bool operator<(const error_code& right) const;

Parameter

right
Das zu vergleichende error_code-Objekt.

Rückgabewert

true wenn das error_code Objekt kleiner als das objekt ist, das error_code zum Vergleich übergeben wird; falseAndernfalls .

Hinweise

Der Memberoperator gibt category() < right.category() || category() == right.category() && value < right.value()zurück.

operator =

Weist dem error_code-Objekt einen neuen Enumerationswert zu.

template <class _Enum>
typename enable_if<is_error_code_enum<_Enum>::value, error_code>::type&
    operator=(_Enum _Errcode);

Parameter

_Errcode
Der Enumerationswert, der dem error_code-Objekt zugewiesen wird.

Rückgabewert

Ein Verweis auf das error_code-Objekt, dem der neue Enumerationswert durch die Memberfunktion zugewiesen wird.

Hinweise

Der Memberoperator speichert (value_type)_Errcode als Fehlercodewert und einen Zeiger auf generic_category. Er gibt *this zurück.

operator bool

Wandelt eine Variable vom Typ error_code um.

explicit operator bool() const;

Rückgabewert

Der boolesche Wert des Objekts error_code.

Hinweise

Der Operator gibt einen Wert zurück, der zu true konvertiert werden kann, allerdings nur wenn value nicht null entspricht. Der Rückgabetyp kann nur zu bool konvertiert werden, nicht zu void * oder zu anderen bekannten skalaren Typen.

value

Gibt den gespeicherten Fehlercodewert zurück.

value_type value() const;

Rückgabewert

Der gespeicherte Fehlercodewert vom Typ value_type.

value_type

Ein Typ, der den gespeicherten Fehlercodewert darstellt.

typedef int value_type;

Hinweise

Diese Typdefinition ist ein Synonym für int.