Compartilhar via


Classe error_code

Representa os erros de sistema de nível inferior específicos à implementação.

Sintaxe

class error_code;

Comentários

Um objeto do tipo de classe error_code armazena um valor de código de erro e um ponteiro para um objeto que representa uma categoria de códigos de erro que descrevem erros de sistema de nível inferior relatados.

Membros

Construtores

Nome Descrição
error_code Constrói um objeto do tipo error_code.

Typedefs

Nome Descrição
value_type Um tipo que representa o valor do código de erro armazenado.

Funções

Nome Descrição
assign Atribui um valor de código de erro e categoria a um código de erro.
category Retorna a categoria de erro.
clear Limpa o valor do código de erro e a categoria.
default_error_condition Retorna a condição de erro padrão.
message Retorna o nome do código de erro.

Operadores

Nome Descrição
operator== Testa a igualdade entre objetos error_code.
operator!= Testa a desigualdade entre objetos error_code.
operator< Testa se o objeto error_code é menor que o objeto error_code passado para comparação.
operator= Atribui um novo valor de enumeração ao objeto error_code.
operator bool Converte uma variável do tipo error_code.

assign

Atribui um valor de código de erro e categoria a um código de erro.

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

Parâmetros

val
O valor de código de erro para armazenar em error_code.

_Cat
A categoria de erro para armazenar em error_code.

Comentários

A função de membro armazena val como o valor de código de erro e um ponteiro para _Cat.

category

Retorna a categoria de erro.

const error_category& category() const;

Comentários

clear

Limpa o valor do código de erro e a categoria.

clear();

Comentários

A função de membro armazena um valor zero de código de erro e um ponteiro para o objeto generic_category.

default_error_condition

Retorna a condição de erro padrão.

error_condition default_error_condition() const;

Valor de Devolução

O error_condition especificado por default_error_condition.

Comentários

Essa função membro retorna category().default_error_condition(value()).

error_code

Constrói um objeto do tipo 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);

Parâmetros

val
O valor de código de erro para armazenar em error_code.

_Cat
A categoria de erro para armazenar em error_code.

_Errcode
O valor da enumeração para armazenar em error_code.

Comentários

O primeiro construtor armazena um valor zero de código de erro e um ponteiro para generic_category.

O segundo construtor armazena val como o valor de código de erro e um ponteiro para error_category.

O terceiro construtor armazena (value_type)_Errcode como o valor de código de erro e um ponteiro para generic_category.

mensagem

Retorna o nome do código de erro.

string message() const;

Valor de Devolução

Uma string que representa o nome do código de erro.

Comentários

Essa função membro retorna category().message(value()).

operator==

Testa a igualdade entre objetos error_code.

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

Parâmetros

direita
O objeto a ser testado quanto à igualdade.

Valor de Devolução

true se os objetos forem iguais; false se os objetos não forem iguais.

Comentários

O operador de membro retorna category() == right.category() && value == right.value().

operator!=

Testa a desigualdade entre objetos error_code.

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

Parâmetros

direita
O objeto a ser testado quanto à desigualdade.

Valor de Devolução

true se o objeto error_code não for igual ao objeto error_code passado em right; caso contrário, é false.

Comentários

O operador de membro retorna !(*this == right).

operator<

Testa se o objeto error_code é menor que o objeto error_code passado para comparação.

bool operator<(const error_code& right) const;

Parâmetros

direita
O objeto error_code a ser comparado.

Valor de Devolução

true se o objeto error_code for menor que o objeto error_code passado para comparação; caso contrário, false.

Comentários

O operador de membro retorna category() < right.category() || category() == right.category() && value < right.value().

operator=

Atribui um novo valor de enumeração ao objeto error_code.

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

Parâmetros

_Errcode
O valor de enumeração a ser atribuído ao objeto error_code.

Valor de Devolução

Uma referência ao objeto error_code ao qual está sendo atribuído um novo valor de enumeração pela função de membro.

Comentários

O operador membro armazena (value_type)_Errcode como o valor de código de erro e um ponteiro para generic_category. Ele retorna *this.

operator bool

Converte uma variável do tipo error_code.

explicit operator bool() const;

Valor de Devolução

O valor booliano do objeto error_code.

Comentários

O operador retornará um valor que pode ser convertido em true somente se o valor não for igual a zero. O tipo de retorno é pode ser convertido apenas para bool, não para void * ou outros tipos escalares conhecidos.

value

Retorna o valor de código de erro armazenado.

value_type value() const;

Valor de Devolução

O valor do código de erro armazenado do tipo value_type.

value_type

Um tipo que representa o valor do código de erro armazenado.

typedef int value_type;

Comentários

Esta definição de tipo é um sinônimo para int.