Skip to content

error_condition.md

Latest commit

 

History

History
113 lines (89 loc) · 5.42 KB

error_condition.md

File metadata and controls

113 lines (89 loc) · 5.42 KB
Raw

error_condition

  • system_error[meta header]
  • std[meta namespace]
  • class[meta id-type]
  • cpp11[meta cpp]
namespace std {
  class error_condition;
}

概要

error_conditionは、error_codeに紐付くエラーを表現することを可能にするためのクラスである。

Visual C++ 2010、GCC 4.6.1ではgeneric_category()とsystem_category()のerror_categoryオブジェクトはname()メンバ関数を除いて同じ挙動を行い、それぞれのdefault_error_condition()メンバ関数も同じエラー値、同じカテゴリのerror_conditionを構築するため、実質error_codeとerror_conditionは標準カテゴリでは等価な動作をする。だが、error_categoryを継承した新たなカテゴリを定義することにより、以下のようなエラーを表現することが可能となる：

  • 一つのエラー値で上位Nビット、下位Nビットで異なるエラー情報を表現する
  • 例： WindowsのHRESULT : 「HRESULT型とは？ - UsefullCode.net」
  • システムのエラーコードを汎用のエラーコードに変換し、error_codeにはシステムの環境依存エラー値、error_conditionには環境依存しない汎用エラー値を格納する

メンバ関数

名前 説明 対応バージョン
(constructor) コンストラクタ C++11
~error_condition() = default デストラクタ C++11
operator= 代入演算子 C++11
assign 値の再設定 C++11
clear エラー情報をクリアする C++11
value エラー値を取得する C++11
category エラーカテゴリを取得する C++11
message エラーメッセージを取得する C++11
explicit operator bool エラーかどうかを判定する C++11

非メンバ関数

名前 説明 対応バージョン
operator== 等値比較 C++11
operator!= 非等値比較 (C++20からoperator==により使用可能) C++11
operator<=> 三方比較 C++20
operator< 左辺が右辺より小さいか判定する (C++20からoperator<=>により使用可能) C++11
bool operator<=(const error_condition&, const error_condition&) noexcept; 左辺が右辺以下か判定する (operator<=>により使用可能) C++20
bool operator>(const error_condition&, const error_condition&) noexcept; 左辺が右辺より大きいか判定する (operator<=>により使用可能) C++20
bool operator>=(const error_condition&, const error_condition&) noexcept; 左辺が右辺以上か判定する (operator<=>により使用可能) C++20
make_error_condition errcからerror_conditionオブジェクトを生成する C++11

その他

名前 説明 対応バージョン
hash error_conditionでの特殊化 C++17

例

#include <iostream>
#include <system_error>

int main()
{
  try {
    // 不正な引数エラー
    std::error_code ec(static_cast<int>(std::errc::invalid_argument),
                       std::generic_category());

    throw std::system_error(ec, "system error!");
  }
  catch (std::system_error& e) {
    // 例外オブジェクトからerror_codeを取得
    const std::error_code& ec = e.code();

    // error_codeからerror_conditionを取得
    const std::error_condition& cond = ec.default_error_condition();

    // エラー値とメッセージを出力
    std::cout << cond.value() << std::endl;
    std::cout << cond.message() << std::endl;
  }
}
  • std::error_condition[color ff0000]
  • std::errc::invalid_argument[link errc.md]
  • std::generic_category()[link generic_category.md]
  • std::system_error[link system_error.md]
  • ec.default_error_condition()[link error_code/default_error_condition.md]
  • cond.value()[link error_condition/value.md]
  • cond.message()[link error_condition/message.md]

出力

22
Invalid argument

バージョン

言語

  • C++11

処理系

参照