hdrstop
Zapewnia dodatkowe kontrolę nad nazwy pliku wstępnej kompilacji oraz nad lokalizacji, w jakim Państwo kompilacji jest zapisywany.
#pragma hdrstop [( "filename" )]
Uwagi
Nazwę pliku jest nazwą pliku nagłówka wstępnie skompilowana lub utworzeniu (zależnie od tego, czy /Yu lub /Yc jest określony).Jeśli nazwę pliku nie zawiera specyfikację ścieżki pliku nagłówka wstępnie skompilowana przyjęto, że w tym samym katalogu co plik źródłowy.
Jeśli plik c lub C++ zawiera hdrstop pragma, gdy kompilowany z /Yc, kompilator zapisuje stan kompilacji do lokalizacji pragma.Skompilowanej dowolnego kodu, który następuje pragma nie jest zapisywany.
Użyj nazwę pliku do nazwy pliku nagłówka wstępnie skompilowanym, w którym zapisany jest w stanie skompilowanym.Odstęp między hdrstop i nazwę pliku jest opcjonalny.Nazwa pliku określona w hdrstop pragma jest ciągiem i dlatego podlegają ograniczeniom dowolny ciąg c lub C++.Musi w szczególności, należy ją ująć w cudzysłów i użyć znaków escape (odwrócona kreska ułamkowa) do określenia nazwy katalogu.Na przykład:
#pragma hdrstop( "c:\\projects\\include\\myinc.pch" )
Nazwa pliku nagłówka wstępnie skompilowana jest ustalona zgodnie z następującymi zasadami, w kolejności:
Argument opcji kompilatora/ol
Nazwę pliku argument #pragmahdrstop
Nazwa podstawowa pliku źródłowego z.Rozszerzenie PCH
Dla opcji /Yc i /Yu, jeśli żadna z opcji dwóch kompilacji, ani też hdrstop pragma Określa nazwę pliku, nazwa podstawowa pliku źródłowego jest używany jako nazwa podstawowa pliku nagłówka wstępnie skompilowana.
Wstępne przetwarzanie polecenia umożliwiają także wykonywać makro zastąpienia w następujący sposób:
#define INCLUDE_PATH "c:\\progra~`1\\devstsu~1\\vc\\include\\"
#define PCH_FNAME "PROG.PCH"
.
.
.
#pragma hdrstop( INCLUDE_PATH PCH_FNAME )
Gdzie rządzą następujące zasady hdrstop pragma mogą być umieszczone:
Musi znajdować się poza wszelkie dane lub deklaracji funkcji lub definicji.
Należy go określić w pliku źródłowym, nie w pliku nagłówkowym.
Przykład
#include <windows.h> // Include several files
#include "myhdr.h"
__inline Disp( char *szToDisplay ) // Define an inline function
{
... // Some code to display string
}
#pragma hdrstop
W tym przykładzie hdrstop pragma pojawia się po dwa pliki zostały uwzględnione i funkcji śródwierszowej została zdefiniowana.To może na początku, wydaje się być nieparzysta położenia pragma.Rozważ, jednak, że ręczne opcje wstępnej kompilacji, /Yc i /Yu, z hdrstop pragma umożliwia wstępnej kompilacji plików źródłowych całego — nawet kodu wbudowanego.Kompilator Microsoft nie ograniczają na autorski, ale także tylko zgłoszenia danych.