このセクションでは、C/C++test で使用できる変数の定義について説明します。

一般的な変数

以下の変数は、レポート、E-mail、Parasoft DTP、ライセンスの設定などの一般的な目的に使用できます。なお、セッションタグの値にコロン (:) を使用することはできません。

analysis_type

$ example: ${analysis_type}

有効な解析タイプのカンマ区切りリストを出力します (例: Static, Generation, Execution)。レポート設定と Email 設定にだけ使用できます。

config_name

$ example: ${config_name}

実行されたテストコンフィギュレーション名を出力します。レポート設定と Email 設定にだけ使用できます。例:

dtp_project

例: $dtp_project}

テスト対象プロジェクトに対応する DTP プロジェクトの名前を出力します。

env_var

例: ${env_var:HOME}

コロンの後に指定された環境変数の値を出力します。

general_project

例: ${general_project}

結果がリンクされる DTP の一般的なプロジェクトの名前を出力します。

project_name

例: ${project_name}

テスト対象プロジェクトの名前を出力します。複数のプロジェクトを入力として渡した場合、この変数は「テスト対象プロジェクト名...」と出力します。

project_loc

例: ${project_loc}

テスト対象プロジェクトの場所を出力します。

solution_name

例: ${solution_name}

テスト対象 Visual Studio ソリューションの名前を出力します。複数のソリューションを入力として渡した場合、この変数は「テスト対象ソリューション名...」と出力します。

solution_loc

例: ${solution_loc}

テスト対象 Visual Studio ソリューションの場所を出力します。

time

例: ${time:yyyy-MM-dd-HH.mm}

現在時刻を出力します。デフォルトの書式は yyyy-MM-dd です。上記の例のように、書式をカスタマイズできます。

tool_name

例: ${tool_name}

Parasoft 製品の名前を出力します (例: C++test)。

workspace_name

例: ${workspace_name}Visual Studio のソリューション名を出力します。例えば、 report.mail.subject=Scanner Results for ${workspace_name} は "Scanner Results for solutionAccoun1.sln" などのように展開されます。

resource_loc

例: ${resource_loc:<RESOURCE_PATH>}

指定されたプロジェクトリソースの場所を出力します。この変数は、適用できる設定でプロジェクトリソースを参照するために使用します。たとえば、リンクされたディレクトリがあるプロジェクトの make 実行ディレクトリや VC 6.0 プロジェクトの .dsp ファイルのパスなどを参照できます。ワークスペースに登録されているとおりのプロジェクト相対論理パスをしていします。

ビルド関連変数

${CPPTEST_SCAN}

この変数はオプションが指定された形で、C++test のオプション抽出ユーティリティとして自動的に初期化されます。C++test がビルドコマンドを実行する環境で設定します。プロジェクトプロパティの [Parasoft] > [C++test] > [ビルド] オプションで Makefile ベースのプロジェクトを構成するときに、ビルドコマンドラインで使用します。C/C++test で make スクリプトまたはビルドスクリプトを実行する場合に、スクリプト中で直接このオプションを使用して、コンパイラ/リンカーを置き換えることができます。

${cpptest:original_options}

ビルドの情報またはプロジェクトファイルの読み取り (Visual Studio または MULTI) から収集された、オリジナルプロジェクト (テスト対象プロジェクト) のオプション。プロジェクトプロパティまたはファイルプロパティのコンパイラ/リンカーオプションで使用されます。

${cpptest:project_lib_files}

Visual Studio のプロジェクト定義またはソリューション定義から収集された依存ライブラリ。プロジェクトプロパティまたはファイルプロパティのコンパイラ/リンカーオプションで使用されます。

テストスイートファイルの変数

キー

file = テスト対象関数が定義されているソース/ヘッダーファイル
source file = テスト対象関数が定義されているコンパイル単位を定義するソースファイル

また、次の変数を使用してテストコンフィギュレーションの [生成] > [テストスイート] タブの [テストスイート出力ファイルとレイアウト] オプションを設定できます。

${test_ext} - テストスイートファイルの C/C++test 固有の拡張子 (.cpp)
${file_name} - ファイル名
${file_base_name} - 拡張子なしのファイル名
${file_ext} - ファイル拡張子
${file_loc} - ファイルの場所
${file_loc_rel} - ファイルの場所 (プロジェクトルートからの相対パス)
${file_uid} - ファイルの一意な識別子
${function_name} - テスト対象の関数名
${function_uid} - テスト対象関数の一意な識別子 (関数のシグニチャ/マングル名からハッシュコード計算された識別子)

その他の変数

一時ファイルのための変数

${cpptest:testware_loc} - C/C++test 一時ファイルの場所使用される場所：

テスト実行作業ディレクトリ
テスト実行フローのカスタマイズ用 XML

構成ファイルのための変数

${cpptest:cfg_dir} - C/C++test コンフィギュレーションファイルの場所使用される場所：

テスト実行フローのカスタマイズ用 XML
スタブファイルの場所
プロジェクト/ファイルプロパティのコンパイラ/リンカーオプション

自動生成スタブのための変数

${cpptest:auto-stubs} - 自動生成スタブファイルの場所。この変数は、テストコンフィギュレーションの [実行] > [シンボル] タブの [自動生成スタブ出力先] の値をポイントします。[ 次の場所で発見されたファイルのシンボルも使用] フィールドに ${cpptest:auto-stubs} 変数を追加すれば、[自動生成スタブ出力先] にあるスタブが使用されます。スタブが生成されるディレクトリとスタブが取得されるディレクトリを簡単に同期させることができます。

使用される場所：

スタブファイルの場所 -- スタブを生成するテストコンフィギュレーションについてのみ

コンテキスト固有スタブのための変数

${ctx_name} - テストされるコンテキストファイルの名前。たとえば foo.cpp
${ctx_base_name} - テストされるコンテキストファイルのベース名。たとえば foo
${ctx_ext} - テストされるコンテキストファイルの拡張子。たとえば cpp
${ctx_loc_rel} - テストされるコンテキストファイルのプロジェクトに依存する場所。たとえばsrc/subdir