この章ではマルチスレッド アプリケーションの単体テストを実行し、データを収集する方法を説明します。
このセクションの内容:
事前準備
マルチスレッド アプリケーションをテストするには、ビルド設定のコンパイラ オプションに次のオプションを追加します。ビルド設定の詳細については 「プロジェクトとファイルのオプション設定」 を参照してください。
"-DCPPTEST_THREADS=1"
このオプションは、C/C++test ランタイム ライブラリのマルチスレッド サポートを有効にし、スレッド関係のルーチンに対するセーフ スタブの使用を無効にします。
注意事項
マルチスレッド アプリケーションをテストするときの注意事項は以下のとおりです。
- C/C++test のテスト実行可能ファイルは適切なランタイム ライブラリ (Visual C++ コンパイラの場合はマルチスレッド版のC ランタイム ライブラリ、UNIX では pthread ライブラリ) とリンクされている必要があります。
- C/C++test ランタイムはスレッドの生存期間をコントロールしません。テスト ケースが完了したときにすべてのスレッドが終了されるようにテスト ケースを実装することを推奨します。
既知の問題と制限事項
既知の問題と制限事項は以下のとおりです。
- -DCPPTEST_THREADS=1 を使用してマルチスレッド サポートを有効にしているが、適切なライブラリがリンクされていない場合 (またはマルチスレッドとシングルスレッドの C ランタイムが混在している場合)、テスト実行可能ファイルは不正なテスト結果を出力したり、予期しないときに終了する可能性があります。
- メイン スレッド以外のスレッドでの予期しない振る舞い (シグナル、処理されない例外、タイムアウトなど) により、テスト実行可能ファイルが終了する場合があります。
C/C++test ランタイム ライブラリのビルド
C/C++test のデフォルトのランタイム ライブラリは、あらかじめマルチ スレッドをサポートしています。たとえば組込みのテストを行うなどのために、マルチスレッドをサポートするカスタム ランタイム ライブラリをビルドする場合を除いて、追加の作業を行う必要はありません。
マルチスレッドをサポートするカスタム ランタイム ライブラリをビルドする必要がある場合、コンパイラ コマンドラインに次を追加します。
"-DCPPTEST_THREADS_ENABLED=1"
サポートされるスレッド API
ランタイム ライブラリ実装は、以下の種類のスレッド API を使用できます。
- Windows スレッド
- POSIX スレッド
- VxWorks 6.x
他のスレッド API の使用
他のスレッド API (またはカスタム API) を使用する必要がある場合、以下の型とルーチンを実装する必要があります。
C/C++test ランタイム ソースの CppTestThread.c ファイルには、スレッド サポート ルーチンの定義が含まれていることに注意してください。このファイルをサンプルとして使用したり、変更のベースとすることができます。
TlS - Thread Local Storage
typedef IMPLEMENTATION_DEPENDENT_TYPE CppTestThreadKey; /** * スレッド ローカル ストレージ データのキーを作成 * 成功時に 0 を返す */ extern int localThreadKeyCreate(CppTestThreadKey* key); /** * スレッド ローカル ストレージ データのキーを削除 * 成功時に 0 を返す */ extern int localThreadKeyDelete(CppTestThreadKey key); /** * キーに関連付けられたスレッド固有の値を返す */ extern void* localThreadGetSpecific(CppTestThreadKey key); /** * スレッド固有の値をキーと関連付ける * 成功時に 0 を返す */ extern int localThreadSetSpecific(CppTestThreadKey key, void* value
Mutex
注意 ! C/C++test ランタイムは、mutex を静的に初期化できると仮定します。
typedef IMPLEMENTATION_DEPENDENT_TYPE CppTestThreadMutex; #define CPPTEST_THREADS_MUTEX_STATIC_INIT <IMPLEMENTATION_DEPENDENT_STATIC_INITIALIZER> /** * mutex の初期化 * @return 0 on success */ extern int localThreadMutexInit(CppTestThreadMutex* mutex); /** * mutex によって使用されたリソースの破壊と解放 * @return 0 on success */ extern int localThreadMutexDestroy(CppTestThreadMutex* mutex); /** * 呼び出し側のスレッドが mutex の所有者の場合 mutex をロックして戻る * @return 0 on success */ extern int localThreadMutexLock(CppTestThreadMutex* mutex); /** * 呼び出し側のスレッドが所有する mutex を解放 * @return 0 on success */ extern int localThreadMutexUnlock(CppTestThreadMutex* mutex);
その他
/** * 呼び出しスレッドを終了する * (never returns) */ extern void localThreadExit(); /** * @return non-zero if threads already finished execution */ extern int localThreadFinished(CppTestThread* thread); /** * @return non-zero if threads are supported in current build * (proper macros, libraries, compiler options were used). */ extern int localThreadsSupported(void); /** * 与えられたスレッド構造を初期化する */ extern void localThreadInit(CppTestThread* thread);