/Yc (プリコンパイル済みヘッダー ファイルの作成)

  • [アーティクル]

特定の時点でのコンパイルの状態を表すプリコンパイル済みヘッダー (.pch) ファイルを作成するようにコンパイラに指示します。

構文

/Yc
/Ycfilename

引数

filename
ヘッダー (.h) ファイルを指定します。 この引数を使用すると、コンパイラは .h ファイルまでのすべてのコードをコンパイルします。

解説

引数を指定せずに /Yc を指定した場合、コンパイラは、ベース ソース ファイルの最後まで、または hdrstop ディレクティブが発生したベース ファイル内のポイントまで、すべてのコードをコンパイルします。 hdrstop プラグマまたは /Fp オプションを使用して別のファイル名を指定しない限り、生成される .pch ファイルのベース名は、ベース ソースファイルと同じになります。

プリコンパイル済みコードは、/Yc オプションで指定されたファイルのベース名と .pch 拡張子から作成された名前のファイルに保存されます。 /Fp (.pch ファイルの名前の指定) オプションを使用して、プリコンパイル済みヘッダー ファイルの名前を指定することもできます。

/Ycfilename を使用した場合、コンパイラは、指定されたファイルまでのすべてのコードをコンパイルして、後で /Yu (プリコンパイル済みヘッダー ファイルの使用) オプションで使用できるようにします。

/Ycfilename オプションと /Yufilename オプションが同じコマンド ラインで発生し、両方とも同じファイル名を参照 (または暗黙的に指定) している場合は、/Ycfilename が優先されます。 この機能により、メイクファイルの記述が簡略化されます。

プリコンパイル済みヘッダーの詳細については、以下を参照してください。

Visual Studio 開発環境でこのコンパイラ オプションを設定するには

  1. .cpp ファイルを選択します。 .cpp ファイルには、プリコンパイル済みヘッダー情報が含まれている .h ファイルを #include する必要があります。 プロジェクトの /Yc 設定は、ファイル レベルでオーバーライドできます。

  2. プロジェクトの [プロパティ ページ] ダイアログ ボックスを開きます。 詳細については、Visual Studio での C++ コンパイラとビルド プロパティの設定に関する記事を参照してください。

  3. [構成プロパティ]、[C/C++]、[プリコンパイル済みヘッダー] プロパティ ページを開きます。

  4. [プリコンパイル済みヘッダー] プロパティを変更します。

  5. filename を設定するには、[プリコンパイル済みヘッダー ファイル] プロパティを変更します。

このコンパイラ オプションをコードから設定するには

例

次のコードがあるとします。

// prog.cpp
// compile with: cl /c /Ycmyapp.h prog.cpp
#include <afxwin.h>   // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h"    // Include information specific to this app
// ...

このコードがコマンド CL /YcMYAPP.H PROG.CPP を使ってコンパイルされると、コンパイラは、AFXWIN.h、RESOURCE.h、および MYAPP.h のすべての前処理を、MYAPP.pch という名前のプリコンパイル済みヘッダー ファイルに保存します。

関連項目

MSVC コンパイラ オプション
MSVC コンパイラ コマンド ラインの構文
プリコンパイル済みヘッダー ファイル