Programming/Boost/Test/リファレンス - bambooflow Note

BoostTestリファレンス

アサーション

検査

BOOST_CHECK( expr );

exprが真であることを確かめる．
exprが偽だと、エラー報告をログに出力。

BOOST_CHECK_MESSAGE( expr, str );

exprが真であることを確かめる．
exprが偽だと、エラー報告とstr文字列をログ出力します．

BOOST_CHECK_PREDICATE( pred, arity, args );

BOOST_CHECK_EQUAL( left, right );

left=rightであることを確かめます．
偽のとき、エラー報告を出力します．
char*のとき、文字列として比較します．

BOOST_CHECK_EQUAL_COLLECTIONS( left_begin, left_end, right_begin, right_end );

BOOST_CHECK_CLOSE( left, right, tolerance );

leftとrightの相対誤差がtoleranceいないに収まっていることを確かめます．
誤差が大きい時、エラー報告を出力します。
浮動小数点の等値の検査に使用します．（ただし、<boost/test/floating_point_comparison.hpp>をインクルードする必要があります．）

BOOST_CHECK_BITWISE_EQUAL( left, right );

leftとrightをビット毎に比較したときに違いがないことを確かめます．
違いがあるとき、エラー報告を出力します．

BOOST_IS_DEFINED( macro );

プリプロセッサマクロmacroが定義されていることを確かめます．
定義されていれば１、去れていなければ0。
BOOST_CHECKの引数として使用します。

BOOST_CHECK_THROW( statement, exception );

statement文での例外の確認。

BOOST_CHECK_NO_THROW( statement );

statement文での例外がないことの確認。

BOOST_CHECK_EXCEPTION( statement, exception, predicate );

必須条件の検査

テスト継続が困難になるような重大エラーの場合は、BOOST_REQUIREを使う。

BOOST_REQUIRE( expr );

BOOST_REQUIRE_MESSAGE( expr, str );

BOOST_REQUIRE_PREDICATE( pred, arity, args );

エラーメッセージ

BOOST_ERROR( str );

BOOST_CHECK_MESSAGE( false, str );と等価。

BOOST_FAIL( str );

BOOST_REQUIRE_MESSAGE( false, str );と等価。

警告メッセージ

BOOST_CHECKPOINT( str );

チェックポイント。
テストプログラムがエラーで実行停止したとき、最後に通過したチェックポイントの名前を出力します。

BOOST_MESSAGE( str );

メッセージを出力します。
log_level=nothingのときは出力されません。

BOOST_WARN( expr );

exprが偽のとき、警告メッセージを出力します。

BOOST_WARN_MESSAGE( expr, str );

exprが偽のとき、str文字列とともに警告メッセージを出力します。

実行時設定

• Boost v1.40

変数名／オプション	指定可能な値	意味
BOOST_TEST_LOG_LEVEL --log_level=		ログ詳細度設定
	all	すべて
	success	成功
	test_suite	テストの入出等のメッセージ
	message	ユーザメッセージ
	warning	警告
	error	エラー
	cpp_exception	レポート非検出のc++例外
	system_error	システムエラー、浮動小数点例外等
	fatal_error	致命的なエラー
	nothing	情報無し