hdrstop
Ön derleme dosya adları üzerinden ve derleme durumu kaydedildiği konumu üzerinde ek denetim sağlar.
#pragma hdrstop [( "filename" )]
Notlar
Dosya adı kullanın veya oluşturmak için önceden derlenmiş üstbilgi dosyası adı (oluşuna göre /Yu veya /Yc belirtilir). Dosya adı bir yol belirtimi içermiyor önceden derlenmiş üstbilgi dosyası kaynak dosyasıyla aynı dizinde olduğu varsayılır.
c veya C++ dosya içeriyorsa, bir hdrstop /Yc ile derlendiğinde pragma derleyici derleme pragma konumunu kadar durumunu kaydeder. Derlenmiş pragma izleyen herhangi bir kodu kaydedilmez.
Use Dosya adı derlenmiş kaydedildiğinde önceden derlenmiş üstbilgi dosyası adı için. Arasında bir boşluk hdrstop ve Dosya adı isteğe bağlıdır. Belirtilen dosya adı hdrstop pragma bir dizedir ve bu nedenle herhangi bir c veya C++ dize kısıtlamalara tabidir. Özellikle, tırnak işaretleri içine alın ve çıkış karakteri (ters eğik çizgi) dizin adlarını belirtmek için kullanın. Örne?in:
#pragma hdrstop( "c:\\projects\\include\\myinc.pch" )
Önceden derlenmiş üstbilgi dosyası adı öncelik sırasına göre aşağıdaki kurallara göre belirlenir:
Bağımsız değişken /Fp derleyici seçeneği
Dosya adı bağımsız değişkeni için #pragmahdrstop
Temel ad kaynak dosyanın bir.pch uzantısı
/Yc ve /Yu seçenekleri için iki derleme seçenekleri hiçbiri, ne de hdrstop temel önceden derlenmiş üstbilgi dosyası adı olarak kullanılan temel kaynak dosyanın adını, pragma dosya adını belirler.
Ön işlem komutları gibi makro değiştirme işlemini gerçekleştirmek için de kullanılabilir:
#define INCLUDE_PATH "c:\\progra~`1\\devstsu~1\\vc\\include\\"
#define PCH_FNAME "PROG.PCH"
.
.
.
#pragma hdrstop( INCLUDE_PATH PCH_FNAME )
Aşağıdaki kurallar where yöneten hdrstop pragma yerleştirilebilir:
Herhangi bir veri veya işlev bildirimi veya tanım dışında yer almalıdır.
Kaynak dosyadaki bir üstbilgi dosyasında belirtilmelidir.
Örnek
#include <windows.h> // Include several files
#include "myhdr.h"
__inline Disp( char *szToDisplay ) // Define an inline function
{
... // Some code to display string
}
#pragma hdrstop
Bu örnekte, hdrstop pragma iki dosyaları dahil edilmiştir ve bir satır içi işlevi tanımlanan sonra görünür. Bu ilk bakışta pragma için tek bir yerleşim için görünebilir. , Ancak bu el ile ön derleme seçenekleri, /Yc ve /Yu, birlikte kullanmayı düşünün hdrstop pragma sayesinde, tüm kaynak dosyaları ön derleme işlemi yapmak mümkün — hatta satır içi kod. Microsoft derleyici, yalnızca veri bildirimleri ön derleme için sınırlama getirmez.