/D (プリプロセッサの定義)
ソース ファイルのプリプロセッサ シンボルを定義します。
/Dname[= | # [{string | number}] ]
解説
このシンボルを #if または #ifdef と一緒に使用すると、ソース コードを条件付きでコンパイルできます。 シンボル定義は、コードで再定義されるまで、または #undef ディレクティブによってコードで未定義になるまで有効です。
/D は、ソース コード ファイルの先頭にある #define ディレクティブと同じ効果があります。ただし、/D ではコマンド ラインの引用符が削除され、#define では保持されます。
既定では、シンボルに関連付けられる値は 1 です。 たとえば、/Dname は、/Dname**=1** と同じです。 この記事の最後の例では、1 を出力するための TEST の定義が示されています。
/Dname**=** を使用してコンパイルすると、シンボルには値が関連付けられません。 シンボルは引き続きコードの条件コンパイルに使用できますが、何も指定されていないものとして評価されます。 この例では、/DTEST= を使用してコンパイルすると、エラーが発生します。 この動作は、値を指定して、または値を指定せずに #define を使用する場合と似ています。
次のコマンドを実行すると、TEST.c で DEBUG シンボルが定義されます。
CL /DDEBUG TEST.C
次のコマンドを実行すると、TEST.c からすべての __far キーワードが削除されます。
CL /D__far= TEST.C
CL 環境変数には、等号 (=) を含む文字列を設定できません。 CL 環境変数で /D を使用するには、等号 (=) ではなくシャープ記号 (#) を指定する必要があります。
SET CL=/DTEST#0
コマンド プロンプトでプリプロセッサ シンボルを定義する場合は、コンパイラ解析規則とシェル解析規則の両方を考慮してください。 たとえば、プログラムでパーセント記号のプリプロセッサ シンボル (%) を定義するには、コマンド プロンプトでパーセント記号 2 文字 (%%) を指定します。パーセント記号を 1 文字だけ指定すると、解析エラーが発生します。
CL /DTEST=%% TEST.C
Visual Studio 開発環境でこのコンパイラ オプションを設定するには
プロジェクトの [プロパティ ページ] ダイアログ ボックスを開きます。 詳細については、「方法 : プロジェクト プロパティ ページを開く」を参照してください。
左ペインで、[構成プロパティ]、[C/C++]、[プリプロセッサ] の順に選択します。
右ペインの [プリプロセッサの定義] プロパティの右側の列で、ドロップダウン メニューを開き、[編集] を選択します。
[プリプロセッサの定義] ダイアログ ボックスで、1 つ以上の定義を追加 (1 行に 1 つ)、変更、または削除します。 [OK] をクリックして変更を保存します。
このコンパイラ オプションをコードから設定するには
- 「PreprocessorDefinitions」を参照してください。
使用例
// cpp_D_compiler_option.cpp
// compile with: /DTEST
#include <stdio.h>
int main( )
{
#ifdef TEST
printf_s("TEST defined %d\n", TEST);
#else
printf_s("TEST not defined\n");
#endif
}