Partilhar via


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 Devolução

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 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_condition.

bool operator==(const error_condition& 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_condition.

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

Parâmetros

direita
O objeto a ser testado quanto à desigualdade.

Valor de Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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.