hdrstop

プリコンパイルのファイル名とコンパイル状態を格納する場所のコントロールを追加します。

#pragma hdrstop [( "filename" )]  

解説

ファイル名は /Yu または /Yc が指定されているかどうか) を使用または作成するプリコンパイル済みヘッダー ファイルの名前です (する。 ファイル名に パスの指定がない場合はプリコンパイル済みヘッダー ファイルはソース ファイルと同じディレクトリにあるものと見なされます。

C または C++. ファイルにが含まれている /Yc を指定してコンパイルする場合コンパイラ hdrstop のプラグマはプラグマの位置までコンパイルの状態を保存します。プラグマに次のコードをコンパイルのステータスは保存されません。

コンパイル状態を保存するプリコンパイル済みヘッダー ファイルの名前に ファイル名を 使用します。hdrstopファイル名 の間の空白は省略可能です。したがって hdrstop のプラグマで指定されたファイル名は文字列でC または C++ 文字列の制約を受けます。特に引用符で囲みディレクトリ名を指定するためにエスケープ文字 (バックス ラッシュ) を使用する必要があります。次に例を示します。

#pragma hdrstop( "c:\\projects\\include\\myinc.pch" )

プリコンパイル済みヘッダー ファイルの名前は優先順位の順で次の規則に従って決定されます :

  1. /Fp コンパイラ オプションに引数

  2. ファイル名の引数プラグマ  #hdrstop

  3. .PCH の拡張子を持つソース ファイルの基本名

2 回のコンパイル オプション hdrstop のプラグマ /Yc と /Yu オプションではファイル名を指定するとソース ファイルの基本名はプリコンパイル済みヘッダー ファイルの基本名として使用されます。

次のように置換を行うプリプロセッサ マクロ コマンドを使用して :

#define INCLUDE_PATH "c:\\progra~`1\\devstsu~1\\vc\\include\\"
#define PCH_FNAME "PROG.PCH"
.
.
.
#pragma hdrstop( INCLUDE_PATH PCH_FNAME )

次の規則は hdrstop のプラグマの場所に配置できる方法を制御します :

  • はデータの外部でまたは関数宣言または関数定義する必要があります。

  • これはソース ファイルではなくヘッダー ファイル内で指定する必要があります。

使用例

#include <windows.h>                 // Include several files
#include "myhdr.h"

__inline Disp( char *szToDisplay )   // Define an inline function
{
    ...                              // Some code to display string
}
#pragma hdrstop

この例ではhdrstop のプラグマは 2 個のファイルが含まれておりインライン関数を定義すると表示されます。これはまずプラグマの時点で配置する可能性があります。考慮するとソース ファイル全体 —インライン コードにプリコンパイルすることをその手動プリコンパイル オプション" /Yc " および " /Yu hdrstop のプラグマを使用することはできます。Microsoft コンパイラがプリコンパイル データ宣言だけに限定されません。

参照

関連項目

プラグマのディレクティブと __Pragma のキーワード