文件的尾部或者出現(xiàn)對同一個(gè)內(nèi)含函數(shù)指定intrinsic編譯指示。function編譯指示只能用于函數(shù)外——在全局層次。

為了列出具有內(nèi)含形式的函數(shù)表，參見#pragma intrinsic。

11  hdrstop

#pragma hdrstop [( "filename" )] 

控制預(yù)編譯頭文件的工作方式。filename是要使用或者創(chuàng)建（依賴于是否指定了/Yu或/Yc）預(yù)編譯頭文件的名字。如果 filename不包括一個(gè)指定路徑，將假定預(yù)編譯頭文件和源文件處于同一個(gè)目錄中。當(dāng)指定自動(dòng)預(yù)編譯頭文件選項(xiàng)/YX時(shí)，所有指定的文件名將被忽略。

如果有/YX或者/Yc選項(xiàng)，而且C或C++文件包含了一個(gè)hdrstop編譯指示時(shí)，編譯程序保存編譯指示之前的編譯狀態(tài)。編譯指示之后的編譯狀態(tài)不被保存。

hdrstop編譯選項(xiàng)不能出現(xiàn)在一個(gè)頭文件內(nèi)。它只能出現(xiàn)在源文件的文件級，它也不能出現(xiàn)在任何數(shù)據(jù)或者函數(shù)的說明或定義之中。

注意，除非指定沒有文件名的/YX選項(xiàng)或者/Yu或/Yc選項(xiàng)，否則hdrstop編譯指示將被忽略。

用一個(gè)文件名命名要保存編譯狀態(tài)的預(yù)編譯頭文件。在hdrstop和filename之間的空格是可選的。在hdrstop編譯指示中的文件名是一個(gè)字符串，這樣它服從于C或C++的字符串規(guī)則。特別的，你必須像下面例子里面顯示的用引號(hào)括起來。

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

預(yù)編譯頭文件的文件名按照如下規(guī)則決定，按照優(yōu)先次序：

/Fp編譯程序選項(xiàng)的參數(shù)；

由#pragma hdrstop的filename參數(shù)；

原文件名的基本文件名加上.PCH擴(kuò)展名。

12  include_alias

#pragma include_alias( "long_filename", "short_filename" )

#pragma include_alias( <long_filename>, <short_filename> )

指定作為long_filename別名的short_filename。一些文件系統(tǒng)允許超出8.3FAT文件系統(tǒng)限制的長頭文件名。編譯程序不能簡單地將長文件名截?cái)酁?/span>8.3名字，因?yàn)殚L頭文件名的前8個(gè)字符可能不是唯一的。無論何時(shí)編譯程序遇到long_filename串，它代替short_filename，并且用short_filename搜索頭文件。這個(gè)編譯指示必須出現(xiàn)在相應(yīng)的#include指示之前。例如：

// First eight characters of these two files not unique.

#pragma include_alias( "AppleSystemHeaderQuickdraw.h", "quickdra.h" )

#pragma include_alias( "AppleSystemHeaderFruit.h", "fruit.h" )

#pragma include_alias( "GraphicsMenu.h", "gramenu.h" )

#include "AppleSystemHeaderQuickdraw.h"

#include "AppleSystemHeaderFruit.h"

#include "GraphicsMenu.h"

這個(gè)別名在搜索時(shí)精確匹配，包括拼寫和雙引號(hào)、尖括號(hào)。include_alias編譯指示在文件名上執(zhí)行簡單的字符串匹配，不進(jìn)行其它的文件名驗(yàn)證。例如，給出下列指示：

#pragma include_alias("mymath.h", "math.h")

#include "./mymath.h"

#include "sys/mymath.h"

并不執(zhí)行別名替代，因?yàn)轭^文件名字符串沒有精確匹配。另外，在/Yu，/Yc和/YX編譯程序選項(xiàng)，或hdrstop編譯指示中作為參數(shù)的頭文件名不被替換。例如，如果你的源文件包含下列指示：

#include <AppleSystemHeaderStop.h>

相應(yīng)的編譯程序選項(xiàng)必須是：

/YcAppleSystemHeaderStop.h

你能夠用include­_alias編譯指示將任何頭文件映射到其它文件。例如：

#pragma include_alias( "api.h", "c:/version1.0/api.h" )

#pragma include_alias( <stdio.h>, <newstdio.h> )

#include "api.h"

#include <stdio.h>

不要混淆用雙引號(hào)和尖括號(hào)括起來的文件名。例如，給出上面的#pragma include_alias指示時(shí)，在下面的#include指示中編譯程序不執(zhí)行替換。

#include <api.h>

#include "stdio.h"

還有，下面的指示將產(chǎn)生一個(gè)錯(cuò)誤：

#pragma include_alias(<header.h>, "header.h")  // Error

注意，在錯(cuò)誤信息中報(bào)告的文件名，或者預(yù)定義宏__FILE__的值，是執(zhí)行替換以后的文件名。例如，在下列指示之后：

#pragma include_alias( "VeryLongFileName.H", "myfile.h" )

#include "VeryLongFileName.H"

文件VeryLongFileName.H產(chǎn)生下列錯(cuò)誤信息：

myfile.h(15) : error C2059 : syntax error

還要注意的是不支持傳遞性。給出下面的指示：

#pragma include_alias( "one.h", "two.h" )

#pragma include_alias( "two.h", "three.h" )

#include "one.h"

編譯程序?qū)⑺阉?/span>two.h而不是three.h。

13  init_seg

C++特有

#pragma init_seg({ compiler | lib | user | "section-name" [, "func-name"]} )

指定影響啟動(dòng)代碼執(zhí)行的關(guān)鍵字或代碼段。因?yàn)槿朱o態(tài)對象的初始化可以包含執(zhí)行代碼，所以你必須指定一個(gè)關(guān)鍵字來定義什么時(shí)候構(gòu)造對象。在使用需要初始化的動(dòng)態(tài)連接庫（DLL）或程序庫時(shí)使用init_seg編譯指示是尤其重要的。

init_seg編譯指示的選項(xiàng)有：

13-1  compiler

由Microsoft C運(yùn)行時(shí)間庫保留。在這個(gè)組中的對象將第一個(gè)構(gòu)造。

13-2  lib

用于第三方類庫開發(fā)者的初始化。在這個(gè)組中的對象將在標(biāo)記為構(gòu)造compiler的對象之后，其它對象之前構(gòu)造。

13-3  user

用于任何其它用戶。在這個(gè)組中的對象將最后構(gòu)造。

13-4  section-name

允許顯式地指定初始化段。在用戶指定的section-name中的對象將不會(huì)隱式地構(gòu)造，而它們的地址將會(huì)被放置在由section-name命名的段中。

13-5  func-name

指定當(dāng)程序退出時(shí)，作為atexit函數(shù)調(diào)用的函數(shù)。這個(gè)函數(shù)必須具有和atexit函數(shù)相同的形式：

int funcname(void (__cdecl *)(void));

如果你需要延遲初始化，你能夠選擇指定顯式的段名。隨后你必須調(diào)用每個(gè)靜態(tài)對象的構(gòu)造函數(shù)。

14  inline_depth

#pragma inline_depth( [0... 255] )

通過控制能夠被擴(kuò)展的一系列函數(shù)調(diào)用（從0到255次）來控制嵌入函數(shù)擴(kuò)展的發(fā)生次數(shù)，這個(gè)編譯指示控制用inline，__inline標(biāo)記的或在/Ob2選項(xiàng)下能自動(dòng)嵌入的嵌入函數(shù)。

inline_depth編譯指示控制能夠被擴(kuò)展的一系列函數(shù)調(diào)用。例如，如果嵌入深度是4，并且如果A調(diào)用B然后調(diào)用C，所有的3次調(diào)用都將做嵌入擴(kuò)展。然而，如果設(shè)置的最近一次嵌入深度是2，則只有A和B被擴(kuò)展，而C仍然作為函數(shù)調(diào)用。

為了使用這個(gè)編譯指示，你必須設(shè)置編譯程序選項(xiàng)/Ob為1或者2。用這個(gè)編譯指示指定的深度設(shè)定在該指示后面的第一個(gè)函數(shù)開始生效。如果你在括號(hào)內(nèi)不指定一個(gè)值，inline_depth設(shè)置嵌入深度到默認(rèn)值8。

在擴(kuò)展時(shí)，嵌入深度可以被減少而不能被增加。如果嵌入深度是6，同時(shí)在擴(kuò)展過程中預(yù)處理程序遇到一個(gè)inline_depth編譯指示設(shè)置為8，則深度保持為6。

嵌入深度0將拒絕嵌入擴(kuò)展，深度255將設(shè)置在嵌入擴(kuò)展時(shí)沒有限制。如果用一個(gè)沒有指定值的編譯指示，則使用為默認(rèn)值。

15  inline_recursion

#pragma inline_recursion( [{on | off}] )

控制直接或者相互間的遞歸函數(shù)調(diào)用式的嵌入擴(kuò)展。用這個(gè)編譯指示控制用inline，__inline標(biāo)記的或在/Ob2選項(xiàng)下能自動(dòng)嵌入的嵌入函數(shù)。使用這個(gè)編譯指示需要設(shè)置編譯程序選項(xiàng)/Ob為1或者2。默認(rèn)的inline_recursion狀態(tài)是off。這個(gè)編譯指示在出現(xiàn)該編譯指示之后第一個(gè)函數(shù)調(diào)用起作用，并不影響函數(shù)的定義。

inline_recursion編譯指示控制如何擴(kuò)展遞歸函數(shù)。如果inline_recursion是off，并且如果一個(gè)嵌入函數(shù)調(diào)用了它自己（直接的或者間接的），函數(shù)將僅僅擴(kuò)展一次。如果inline_recursion是on,函數(shù)將擴(kuò)展多次直到達(dá)到inline_depth的值或者容量限制。

16  intrinsic

#pragma intrinsic( function1 [, function2, ...] )

指定對在編譯指示參數(shù)表中函數(shù)調(diào)用是內(nèi)含的。編譯程序像嵌入代碼一樣生成內(nèi)含函數(shù)，而不是函數(shù)調(diào)用。下面列出了具有內(nèi)含形式的庫函數(shù)。一旦遇到intrinsic編譯指示，它從第一個(gè)包含指定內(nèi)含函數(shù)的函數(shù)定義開始起作用。作用持續(xù)到源文件尾部或者出現(xiàn)包含相同內(nèi)含函數(shù)的function編譯指示。intrinsic編譯指示只能用在函數(shù)定義外——在全局層次。

下列函數(shù)具有內(nèi)含形式：

使用內(nèi)含函數(shù)的程序更快，因?yàn)樗鼈儧]有函數(shù)調(diào)用的額外代價(jià)，然而因?yàn)橛懈郊拥拇a生成，可能比較大。

注意，_alloca和setjmp函數(shù)總是內(nèi)含的，這個(gè)行為不受intrinsic編譯指示影響。

下列浮點(diǎn)函數(shù)沒有內(nèi)含形式。然而它們具有直接將參數(shù)通過浮點(diǎn)芯片傳送而不是推入程序堆棧的版本。

當(dāng)你同時(shí)指定/Oi和/Og編譯程序選項(xiàng)（或者任何包含/Og，/Ox，/O1和/O2的選項(xiàng)）時(shí)下列浮點(diǎn)函數(shù)具有真正的內(nèi)含形式。

你可以用編譯程序選項(xiàng)/Op或/Za來覆蓋真內(nèi)含浮點(diǎn)選項(xiàng)的生成。在這種情況下，函數(shù)會(huì)像一般庫函數(shù)一樣被生成，同時(shí)直接將參數(shù)通過浮點(diǎn)芯片傳送而不是推入程序堆棧。

17  message

#pragma message( messagestring )

不中斷編譯，發(fā)送一個(gè)字符串文字量到標(biāo)準(zhǔn)輸出。message編譯指示的典型運(yùn)用是在編譯時(shí)顯示信息。

下面的代碼段用message編譯指示在編譯過程中顯示一條信息：

#if _M_IX86 == 500

#pragma message( "Pentium processor build" )

#endif

messagestring參數(shù)可以是一個(gè)能夠擴(kuò)展成字符串文字量的宏，并且你能夠用字符串文字量和宏的任何組合來構(gòu)造。例如，下面的語句顯示被編譯文件的文件名和文件最后一次修改的日期和時(shí)間。

#pragma message( "Compiling " __FILE__ )

#pragma message( "Last modified on " __TIMESTAMP__ )

18  once

#pragma once

指定在創(chuàng)建過程中該編譯指示所在的文件僅僅被編譯程序包含（打開）一次。該編譯指示的一種常見用法如下：

//header.h

#pragma once

// Your C or C++ code would follow:

19  optimize

僅在專業(yè)版和企業(yè)版中存在

#pragma optimize( "[optimization-list]", {on | off} )

代碼優(yōu)化僅有Visual C++專業(yè)版和企業(yè)版支持。詳見Visual C++ Edition。

指定在函數(shù)層次執(zhí)行的優(yōu)化。optimize編譯選項(xiàng)必須在函數(shù)外出現(xiàn)，并且在該編譯指示出現(xiàn)以后的第一個(gè)函數(shù)定義開始起作用。on和off參數(shù)打開或關(guān)閉在optimization-list指定的選項(xiàng)。

optimization-list能夠是0或更多個(gè)在表2.2中給出的參數(shù)：

表 2.2   optimize編譯指示的參數(shù)

這些和在/O編譯程序選項(xiàng)中使用的是相同的字母。例如：

#pragma optimize( "atp", on )

用空字符串（""）的optimize編譯指示是一種特別形式。它要么關(guān)閉所有的優(yōu)化選項(xiàng)，要么恢復(fù)它們到原始（或默認(rèn)）的設(shè)定。

#pragma optimize( "", off )

.

.

.

#pragma optimize( "", on )

20  pack

#pragma pack( [ n] )

指定結(jié)構(gòu)和聯(lián)合成員的緊縮對齊。盡管用/Zp選項(xiàng)設(shè)定整個(gè)翻譯單元的結(jié)構(gòu)和聯(lián)合成員的緊縮對齊，可以用pack編譯指示在數(shù)據(jù)說明層次設(shè)定緊縮對齊。從出現(xiàn)該編譯指示后的第一個(gè)結(jié)構(gòu)或者聯(lián)合說明開始生效。這個(gè)編譯指示不影響定義。

當(dāng)你使用#pragma pack(n)，其中n是1，2，4，8或者16，第一個(gè)以后的每個(gè)結(jié)構(gòu)成員保存在較小的成員類型或者n字節(jié)邊界上。如果你使用沒有參數(shù)的#pragma pack，結(jié)構(gòu)成員將被緊縮到由/Zp指定的值。默認(rèn)的/Zp緊縮的大小是/Zp8。

編譯程序還支持下面的增強(qiáng)語法：

#pragma pack( [ [ { push | pop}, ] [  identifier, ] ] [ n ] )

該語法允許你將使用不同緊縮編譯指示的組件合并到同一個(gè)翻譯單元內(nèi)。

每次出現(xiàn)有push參數(shù)的pack編譯指示將保存當(dāng)前的緊縮對齊值到一個(gè)內(nèi)部的編譯程序堆棧。編譯指示的參數(shù)列表從左向右讀取。如果你使用了push，當(dāng)前緊縮值被保存。如果你提供了一個(gè)n值，這個(gè)值將成為新的緊縮值。如果你指定了一個(gè)你選定的標(biāo)示符，這個(gè)標(biāo)示符將和新的緊縮值關(guān)聯(lián)。

每次出現(xiàn)有pop參數(shù)的pack編譯指示從內(nèi)部編譯程序堆棧頂部取出一個(gè)值并將那個(gè)值作為新的緊縮對齊。如果你用了pop，而內(nèi)部編譯程序堆棧是空的，對齊值將從命令行得到，同時(shí)給出一個(gè)警告。如果你用了pop并指定了n的值，那個(gè)值將成為新的緊縮值。如果你用了pop并指定了一個(gè)標(biāo)示符，將移去所有保存在堆棧中的的值直到匹配的找到匹配的標(biāo)示符，和該標(biāo)示符關(guān)聯(lián)的緊縮值也被從堆棧中移出來成為新的緊縮值。如果沒有找到匹配的標(biāo)示符，將從命令行獲取緊縮值并產(chǎn)生一個(gè)1級警告。默認(rèn)的緊縮對齊是8。

pack編譯指示的新的增強(qiáng)功能允許你編寫頭文件保證在使用頭文件之前和其后的緊縮值是一樣的：

/* File name: include1.h

*/

#pragma pack( push, enter_include1 )

/* Your include-file code ... */

#pragma pack( pop, enter_include1 )

/* End of include1.h */

在前面的例子中，進(jìn)入頭文件時(shí)將當(dāng)前緊縮值和標(biāo)示符enter_include1關(guān)聯(lián)并推入，被記住。在頭文件尾部的pack編譯選項(xiàng)移去所有在頭文件中可能遇到的緊縮值并移去和enter_include1關(guān)聯(lián)的緊縮值。這樣頭文件保證了在使用頭文件之前和其后的緊縮值是一樣的。

新功能也允許你在你的代碼內(nèi)用pack編譯指示為不同的代碼，例如頭文件設(shè)定不同的緊縮對齊。

#pragma pack( push, before_include1 )

#include "include1.h"

#pragma pack( pop, before_include1 )

在上一個(gè)例子中，你的代碼受到保護(hù)，防止了在include.h中的任何緊縮值的改變。

21  pointers_to_members

C++特有

#pragma pointers_to_members(pointer-declaration, [most-general-representation] )

指定是否能夠在相關(guān)類定義之前說明一個(gè)指向類成員的指針，并且用于控制指針的大小和解釋指針的代碼。你能夠在你的源代碼中使用pointers_to_members編譯知識(shí)來代替/vmx編譯程序選項(xiàng)。

pointer-declaration參數(shù)指出是否在相關(guān)函數(shù)定義之前或其后你已經(jīng)說明了一個(gè)指向成員的指針。pointer-declaration參數(shù)是下面兩個(gè)符號(hào)之一：

most-general-representaion參數(shù)指出在一個(gè)翻譯單元中編譯程序能夠安全引用任何指向類成員指針的最小指針表示方式。這個(gè)參數(shù)可以是下列之一：

22  setlocale

#pragma setlocale( "locale-string" )

定義用于翻譯寬字符常數(shù)和字符串文字量時(shí)用的地區(qū)（國家和語言）。由于用于從多字節(jié)字符轉(zhuǎn)換到寬字符的算法根據(jù)地區(qū)或者由于在運(yùn)行可執(zhí)行程序不同的地方進(jìn)行編譯而不同，這個(gè)編譯指示提供一種在編譯時(shí)指定目標(biāo)地區(qū)的方式。這保證寬字符字符串將以正確的格式保存。默認(rèn)的locale-string是“C”。“C”地區(qū)將字符串中的每個(gè)字符作為wchar_t（即unsigned int）映射其值。

23  vtordisp

C++特有

#pragma vtordisp({on | off} )

允許隱藏的附加vtordisp構(gòu)造函數(shù)/析構(gòu)函數(shù)替換成員。vtordisp編譯指示僅能夠用于具有虛擬基類的代碼。如果派生類從一個(gè)虛擬基類重載了一個(gè)虛擬函數(shù)，并且如果派生類的構(gòu)造函數(shù)或析構(gòu)函數(shù)用指向虛擬基類的指針調(diào)用了這個(gè)函數(shù)，編譯程序?qū)⒏鶕?jù)虛擬基類在類中引入一個(gè)附加的隱藏“vtordisp”域。

vtodisp編譯選項(xiàng)影響它后面的類布局。/vd0和/vd1選項(xiàng)為整個(gè)模塊指定了相同的行為。指定off將禁止隱藏的vtordisp成員，指定on（默認(rèn)）將在它們需要的時(shí)候允許vtordisp。僅在不可能出現(xiàn)類的構(gòu)造函數(shù)和析構(gòu)函數(shù)通過this指針調(diào)用其指向?qū)ο笾械奶摂M函數(shù)時(shí)才關(guān)閉vtordisp。

#pragma vtordisp( off )

class GetReal : virtual public { ... };

#pragma vtordisp( on )

24  warning

#pragma warning( warning-specifier : warning-number-list [,warning-specifier : warning-number-list...] )

#pragma warning( push[ , n ] )

#pragma warning( pop )

允許有選擇地修改編譯程序警告信息的行為。

warning-specifier能夠是下列值之一：

warning-number_list能夠包含任何警告編號(hào)。如下，在一個(gè)編譯指示中可以指定多個(gè)選項(xiàng)：

#pragma warning( disable : 4507 34; once : 4385; error : 164 )

這等價(jià)于：

#pragma warning( disable : 4507 34 )  // Disable warning messages

                                            //  4507 and 34.

#pragma warning( once : 4385 )         // Issue warning 4385

                                            //  only once.

#pragma warning( error : 164 )         // Report warning 164

                                            //  as an error.

對于那些關(guān)于代碼生成的，大于4699的警告標(biāo)號(hào)，warning編譯指示僅在函數(shù)定義外時(shí)有效。如果指定的警告編號(hào)大于4699并且用于函數(shù)內(nèi)時(shí)被忽略。下面例子說明了用warning編譯指示禁止、然后恢復(fù)有關(guān)代碼生成警告信息的正確位置：

int a;

#pragma warning( disable : 4705 )

void func()

{

    a;

}

#pragma warning( default : 4705 )

warning編譯指示也支持下面語法：

#pragma warning( push [ ,n ] )

#pragma warning( pop )

這里n表示警告等級（1到4）。

warning(push)編譯指示保存所有警告的當(dāng)前警告狀態(tài)。warning(push,n)保存所有警告的當(dāng)前狀態(tài)并將全局警告等級設(shè)置為n。

warning(pop)彈出最后一次推入堆棧中的警告狀態(tài)。任何在push和pop之間改變的警告狀態(tài)將被取消。考慮下面的例子：

#pragma warning( push )

#pragma warning( disable : 4705 )

#pragma warning( disable : 4706 )

#pragma warning( disable : 4707 )

// Some code

#pragma warning( pop )

在這些代碼的結(jié)束，pop恢復(fù)了所有警告的狀態(tài)（包括4705，4706和4707）到代碼開始時(shí)候的樣子。

當(dāng)你編寫頭文件時(shí)，你能用push和pop來保證任何用戶修改的警告狀態(tài)不會(huì)影響正常編譯你的頭文件。在頭文件開始的地方使用push，在結(jié)束地方使用pop。例如，假定你有一個(gè)不能順利在4級警告下編譯的頭文件，下面的代碼改變警告等級到3，然后在頭文件的結(jié)束時(shí)恢復(fù)到原來的警告等級。

#pragma warning( push, 3 )

// Declarations/ definitions

#pragma warning( pop )

原文地址 http://tb.blog.csdn.net/TrackBack.aspx?PostId=1621227