Classe error_condition
Representa códigos de erro definidos pelo usuário.
Sintaxe
class error_condition;
Comentários
Um objeto do tipo error_condition
armazena um valor de código de erro e um ponteiro para um objeto que representa uma categoria de códigos de erro usados para os erros relatados definidos pelo usuário.
Membros
Construtores
Nome | Descrição |
---|---|
error_condition | Constrói um objeto do tipo error_condition . |
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 uma condição de erro. |
category | Retorna a categoria de erro. |
clear | Limpa o valor do código de erro e a categoria. |
message | Retorna o nome do código de erro. |
Operadores
Nome | Descrição |
---|---|
operator== | Testa a igualdade entre objetos error_condition . |
operator!= | Testa a desigualdade entre objetos error_condition . |
operator< | Testa se o objeto error_condition é menor que o objeto error_code passado para comparação. |
operator= | Atribui um novo valor de enumeração ao objeto error_condition . |
operator bool | Converte uma variável do tipo error_condition . |
assign
Atribui um valor de código de erro e categoria a uma condição 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;
Valor de retorno
Uma referência à categoria do erro armazenado
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.
error_condition
Constrói um objeto do tipo error_condition
.
error_condition();
error_condition(value_type val, const error_category& _Cat);
template <class _Enum>
error_condition(_Enum _Errcode,
typename enable_if<is_error_condition_enum<_Enum>::value,
error_code>::type* = 0);
Parâmetros
val
O valor de código de erro para armazenar em error_condition
.
_Cat
A categoria de erro para armazenar em error_condition
.
_Errcode
O valor da enumeração para armazenar em error_condition
.
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 retorno
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_condition
.
bool operator==(const error_condition& right) const;
Parâmetros
direita
O objeto a ser testado quanto à igualdade.
Valor de retorno
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_condition
.
bool operator!=(const error_condition& right) const;
Parâmetros
direita
O objeto a ser testado quanto à desigualdade.
Valor de retorno
true
se o objeto error_condition
não for igual ao objeto error_condition
passado em right; caso contrário, é false
.
Comentários
O operador de membro retorna !(*this == right)
.
operator<
Testa se o objeto error_condition
é menor que o objeto error_code
passado para comparação.
bool operator<(const error_condition& right) const;
Parâmetros
direita
O objeto error_condition
a ser comparado.
Valor de retorno
true
se o objeto error_condition
for menor que o objeto error_condition
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_condition
.
template <class _Enum>
error_condition(_Enum error,
typename enable_if<is_error_condition_enum<_Enum>::value,
error_condition>::type&
operator=(Enum _Errcode);
Parâmetros
_Errcode
O valor de enumeração a ser atribuído ao objeto error_condition
.
Valor de retorno
Uma referência ao objeto error_condition
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)error
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_condition
.
explicit operator bool() const;
Valor de retorno
O valor booliano do objeto error_condition
.
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 retorno
O valor do código de erro armazenado do tipo value_type.
Comentários
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
.