自動生成テストケースへのアクセス

自動生成テストケースはテストスイートファイルに保存されます。デフォルト設定では、C++test は1 つのファイルにつき 1 つのテストスイートを生成します。設定を変えれば、1 つの関数につき 1 つのテストスイートを生成することもできます。詳細については「[テストスイート] タブ」および「生成オプションのカスタマイズ」を参照してください。

自動生成されたテストケースを参照するには、次の操作を行います。

プロジェクトツリーで、生成されたテストスイートファイルを探します。
- デフォルトでは、自動生成テストクラスはテスト対象プロジェクト内の tests/autogenerated ディレクトリに保存されます。
- テストスイートファイルの保存先を確認または変更するには、テストに使用したテストコンフィギュレーションを開き、[生成] タブの [テストスイート] タブの [テストスイート出力ファイルとレイアウト] フィールドを参照します。詳細については「[テストスイート] タブ」を参照してください。
プロジェクトツリーで、生成されたテストクラスのノードをダブルクリックします。エディターが開き、テストクラスファイルが表示されます。

テストケースとは

テストケースはテストスイート中に格納されます。

テストスイートは、テストケースのための一種のフレームワークであり、テストケースをグループ化するのに役立ちます。各テストスイートは、CppTest_TestSuite クラスから派生した 1 つのクラス定義、テストケースの宣言、およびテストケース関数の定義を持ちます。
- C++ の関数またはクラスメソッドに対して生成されたテストスイートは、クラスの形を取り、テストケースはこのクラスの public メソッドになります。テストされたメソッドがクラスメンバーである場合、テストスイートクラスは、テスト対象メソッドが属するクラスへのフレンドになります。テストケース内からテスト対象クラスの private メンバーを制御できるため、この関係は非常に強力です。
- C コードのテストスイートは、グローバル関数を宣言するための「コンテナー」(ファイル) としてだけ使用されます。
テストケースは、テストスイートクラスの public メソッド (C++ の場合) またはグローバル関数 ( C の場合) であり、次の 3 つのセクションを持ちます。

引数と事前条件の代入
テストされる関数呼び出し
結果と事後条件の検証 C++test は結果を制御して検証するための一連のマクロを定義しています。これらのマクロは、テスト用実行モジュールから C++test GUI にメッセージとアサーションを渡すために使用できます。利用可能なマクロについては「C++test API ドキュメント」を参照してください。

テスト対象のファイルに後で関数を追加した場合、更新されたファイルにテスト生成が実行されて、新しいテストケースが元のテストスイートファイルに追加されます。

コンテキストマクロとインクルードマクロ

各テストスイートは、次の 2 つのマクロから開始します。

CPPTEST_CONTEXT: テストスイートがテストするファイルを指定します。1 つのソースファイルだけを指定できます。コンテキストの指定がない場合、プロジェクトが実行されるたびにテストスイートが実行されます。
- テストの実行前にプロジェクトツリーでソースファイルまたはディレクトリを選択した場合、C++test はテストコンフィギュレーションの [実行] > [全般] タブの [テストスイートファイルの場所のパターン] オプションで指定されたすべてのテストディレクトリをスキャンします。指定のコンテキストに一致するすべてのテストスイートが実行されます。
- プロジェクト全体を選択した場合、テストパス上のすべてのテストスイートが実行されます。
- 1 つのテストスイートまたは 1 つのテストを選択した場合、CPPTEST_CONTEXT マクロは、このテストスイートが関連するソースファイルをバックトレースするために使用されます。選択したテストスイートだけが実行されます。
CPPTEST_TEST_SUITE_INCLUDED_TO: このテストスイートがインクルードテストスイートであることを指定するほか、テスト用実行モジュールをビルドするときにこのテストスイートソースをインクルードするファイルを指定します。他のテストスイートファイルをインクルードする場合は #include ディレクティブを使用します。

これらのマクロで指定するファイルは、テスト対象ファイルのファイル名と一致しなければなりません。テスト対象ファイルのファイル名を変更した場合、マクロ側のファイル名も合わせて変更する必要があります。

これらのマクロでは相対パスを使用できます。相対パスは "./" または "../" で開始しなければなりません。

事後条件マクロ

次の事後条件マクロは、テストの実行中に変数またはクラスメンバーが保持した値をレポートするために使用されます。

CPPTEST_POST_CONDITION_BOOL(value_string, value)
CPPTEST_POST_CONDITION_INTEGER(value_string, value)
CPPTEST_POST_CONDITION_UINTEGER(value_string, value)
CPPTEST_POST_CONDITION_FLOAT(value_string, value)
CPPTEST_POST_CONDITION_CSTR(value_string, value)
CPPTEST_POST_CONDITION_CSTR_N(value_string, value, max_size)
CPPTEST_POST_CONDITION_MEM_BUFFER(value_string, value, size)
CPPTEST_POST_CONDITION_PTR(value_string, value)

これらのマクロの結果 ( レポートされたすべてのアサーション値) は [品質タスク] ビューに表示されます。事後条件がレポートされたテストケースは、回帰テストで使用するために自動的に「検証済み」にできます。検証済みにすることによって、 *_POST_CONDITION_* マクロはアサーションに変換され、今後のテストで期待値 (検証済みの値) が出力されなかった場合、このアサーションは失敗します。この機能は特に、レガシーコードをベースにした回帰テストを自動生成するのに役立ちます。テストケースの検証の詳細については「回帰テストと例外検出のためのテストケースの生成」を参照してください。

その他のマクロ

アサーションマクロは、ユーザーが事後条件を検証したときにテストケースに追加されます。

テストのニーズに合わせて他のマクロを追加することも可能です。テストケースで使用できるマクロの一覧については「C++test API ドキュメント」を参照してください。

テスト関数

自動生成テストケースは、特別な関数を持つことがあります。たとえば、最大値や最小値にアクセスする関数などです。

C++test ランタイムライブラリには、異なる数値を使ってテストケースを生成するために、整数型および浮動小数点型の最大値/最小値を返す関数が用意されています。次の表中のすべての関数はユーザー定義テストケースで使用できます。

関数	目的
`char cpptestLimitsGetMaxChar(void);`	char 型の最大値を返します。
`char cpptestLimitsGetMinChar(void);`	char 型の最小値を返します。
`signed char cpptestLimitsGetMaxSigned Char(void);`	signed char 型の最大値を返します。
`signed char cpptestLimitsGetMinSigned Char(void);`	signed char 型の最小値を返します。
`unsigned char cpptestLimitsGetMaxUnsigned Char(void);`	unsigned char 型の最大値を返します。
`short cpptestLimitsGetMaxShort(void);`	short 型の最大値を返します。
`short cpptestLimitsGetMinShort(void);`	short 型の最小値を返します。
`unsigned short cpptestLimitsGetMax UnsignedShort(void);`	unsigned short 型の最大値を返します。
`int cpptestLimitsGetMaxInt(void);`	int 型の最大値を返します。
`int cpptestLimitsGetMinInt(void);`	int 型の最小値を返します。
`unsigned int cpptestLimitsGetMaxUnsigned Int(void);`	unsigned int 型の最大値を返します。
`long cpptestLimitsGetMaxLong(void);`	long 型の最大値を返します。
`long cpptestLimitsGetMinLong(void);`	long 型の最小値を返します。
`unsigned long cpptestLimitsGetMaxUnsigned Long(void);`	unsigned long 型の最大値を返します。
`float cpptestLimitsGetMaxPosFloat(void);`	float 型の正の最大値を返します。
`float cpptestLimitsGetMinNegFloat(void);`	float 型の負の最小値を返します。
`float cpptestLimitsGetMaxNegFloat(void);`	float 型の負の最大値を返します。
`float cpptestLimitsGetMinPosFloat(void);`	float 型の正の最小値を返します。
`double cpptestLimitsGetMaxPosDouble(void);`	double 型の正の最大値を返します。
`double cpptestLimitsGetMinNegDouble(void);`	double 型の負の最小値を返します。
`double cpptestLimitsGetMaxNegDouble(void);`	double 型の負の最大値を返します。
`double cpptestLimitsGetMinPosDouble(void);`	double 型の正の最小値を返します。
`long double cpptestLimitsGetMaxPosLong Double(void);`	long double 型の正の最大値を返します。
`long double cpptestLimitsGetMinNegLong Double(void);`	long double 型の負の最小値を返します。
`long double cpptestLimitsGetMaxNegLong Double(void);`	long double 型の負の最大値を返します。
`long double cpptestLimitsGetMinPosLongDouble(void);`	long double 型の正の最小値を返します。

自動生成スタブ

詳細については「自動生成スタブのカスタマイズ」を参照してください。

自動生成テスト ケースへのアクセス

テスト ケースとは