Boostテストライブラリ: 実行モニター

イントロダクション
 利益
 詳細
 コンパイル
 サンプル
 関連情報
 設計

イントロダクション

Boostテストライブラリの実行モニターはユーザの作成した関数を呼出し、面倒なエラー検出からユーザを解放するものである。実行モニターを使用するには boost::execution_monitorから派生したクラスを作成し、int execution_monitor::function()をオーバーライトする。モニター関数を開始するには、 execution_monitor::execute( timeout )メンバ関数を呼び出す。実行モニターの実装において、すべてのシンボルはネームスペースboost以下に配置されている。

利益

エラー探知関数を決められた方法で実行し、統一形式でエラーを通知する。

boost::execution_monitorの詳細

boost::execution_monitorはいくつかの種類のシグナルや例外を、統一的に検知・報告し、種々のエラーをboost::execution_exceptionに変換して呼び出し側に返す。

使用法:

execution_monitorから派生したクラスを作成する。
仮想関数であるint execution_monitor::function()をオーバーライトする。
execution_monitor::execute( timeout )を呼び出す. timeout 引数で指定した時間(秒)後にtimer_error 例外が発生する。プラットフォームによっては無視される場合がある。

効果:

try/catchブロック内にて execution_monitor::function()を呼び出しを行うのだが、この関数が詳細のわからない、プラットフォーム依存のエラー検知コードを含む場合がある。キャッチされていない例外、ハードウェアまたはソフトウェアシグナル、その他の例外が発生した場合には、boost::execution_exceptionを発生する。 execution_monitor::execute() は the execution_monitor::function()がエラーとして非ゼロ値を返すことを想定していない。

返り値:

execution_monitor::function()が返す整数値。

boost::execution_exceptionの詳細

class execution_exception {
public:
    enum error_code {
        cpp_exception_error,    // note (1) 参照
        system_error,           // note (2) 参照
        timeout_error,          // いくつかのプラットフォームのみ検出可能
        user_fatal_error,       // ユーザによって報告された致命的エラー
        system_fatal_error      // note (2) を見よ
    };

    error_code code() const;
    char const what() const;
};

Note 1: キャッチされていないC++例外のみがエラーとして扱われる。アプリケーション内で例外をキャッチしている場合、その例外は boost::execution_monitorには到達しない。

Note 2: これらのエラーは、UNIXシグナルまたはWindows構造化例外を含む。これらの多くはハードウェアトラップが原因で起きる。

何がfatal_system_exceptionで何が単なる system_exceptionであるかは実装次第である。致命的エラーが起きるのは、実行を継続するのが不適当であるスタックオーバーフローやアドレッシング例外など、マシンが破損状態である場合が多い。

実行モニターコンパイル

実行モニターを単独で使用するときには、プロジェクトにexecution_monitor.cppをインクルードする。これは他のすべてのBoostテストライブラリコンポーネントの一部として提供されている。

サンプル

実行モニターを使用した例についてはプログラム実行モニターまたはユニットテストフレームワークを見よ。

設計

Boostテストライブラリ設計ドキュメントでは、実行モニターとその他のコンポーネントとの関連性について述べている。

Revised: 12 February, 2003

オリジナルの、及びこの著作権表示が全ての複製の中に現れる限り、この文書の複製、利用、変更、販売そして配布を認める。このドキュメントは「あるがまま」に提供されており、いかなる明示的、暗黙的保証も行わない。また、いかなる目的に対しても、その利用が適していることを関知しない。