BCB6中的#Pragma说明<转>

1．#pragma alignment
       alignment pragma用于显示一条当前内存对齐（alignment）和枚举（enum）字节大小的消息。例如：
W8035: The alignment is 8 bytes, the enum size is 4 bytes
该消息必须在打开编译器选项“show general messages”或编译器开关“-wmsg”后才能显示。
2．#pragma anon_struct
       #pragma anon_struct on        允许编译类中内嵌的匿名结构
#pragma anon_struct off              禁止编译类中内嵌的匿名结构
例如：
#pragma anon_struct on
struct S
{
    int i;
    struct                          // Embedded anonymous struct
{                       
           int  j ;
          float x ;
    };
S() { i = 1; }
};
#pragma anon_struct off
3．#pragma argsused
       argsused pragma通常在定义一个函数前使用，用于屏蔽函数参数未使用的警告。例如：
#pragma   argsused
       int func(int a,int b)
{
       ++b;
       return b;
}
如果不使用该pragma，编译器就会报类似“函数参数没有用到”的警告消息。
4．#pragma checkoption optionstring
       checkoption pragma检查optionstring中包含的选项是否已设置。例如：
#pragma checkoption -a4 –b
如果没有设置，显示一个错误：E2471: pragma checkoption failed: options are not as expected。
5．#pragma codeseg
#pragma codeseg <seg_name> <"seg_class"> <group>
codeseg pragma用于重命名函数代码所在的段（segment）、类(class)、组（group）。如果codeseg后没有任何选项，表示使用缺省代码段。
6．#pragma comment
#pragma comment (comment type, "string")
comment pragma用于将一个comment记录写入到输出文件。Comment类型可以下列值之一：
exestr      编译器将string写入到一个.obj文件中，最终放置到可执行文件中。使用文件搜索工具可以从可执行文件中找到该string。
lib           连接器将一个string中指定的.lib文件写入到一个.obj文件中。
user        编译器将string写入到一个.obj文件中，但连接器忽略，就是说最终string不放置到可执行文件中。
7．#pragma defineonoption and #pragma undefineonoption
       #pragma defineonoption name switch(es)
#pragma undefineonoption name switch(es)
这两个pragma用于为若干个命令行开关建立一个别名（name）。除了部分负责输入的命令行开关（如-I、-L）外，大部分命令开关都可以在这两个指示符中使用。
#pragma defineonoption在别名中所有指定开关都已打开的情况下定义name。
#pragma undefineonoption在别名中所有指定开关都已打开的情况下不定义name。
 
例如，myfile.c文件包含下列代码：
#pragma defineonoption OPTIMIZING -O2
#ifdef    OPTIMIZING
#pragma message We are optimizing with -O2
#else
#pragma message There are no optimizations turned on
#endif
 
bcc32 -c myfile.c，输出是There are no optimizations turned on
bcc32 -c -O2 myfile.c，输出是We are optimizing with -O2
 
下面是一个同时使用多个命令行开关的实例：
#define SWITCHES_ARE_OFF
#pragma undefineonoption SWITCHES_ARE_OFF -O2 -c -P -C
#ifdef    SWITCHES_ARE_OFF
#pragma message At least one of the switches is not turned on
#else
#pragma message All switches are turned on
#endif
 
bcc32 -c myfile.c，输出是At least one of the switches is not turned on
bcc32 -c -P -O2 -C，输出是All switches are turned on
8.  #pragma exit and #pragma startup
       #pragma startup function-name <priority>
#pragma exit function-name <priority>
这两个pragma分别用于指定在main函数调用前调用和在_exit函数调用前调用的函数。函数定义格式如下：
void func(void);
priority参数数值范围为64－255，0值级别最高。级别越高，在main函数调用前越早调用，在-exit函数调用前越晚调用。缺省级别为100。0－63级别C库保留使用。
9．#pragma hdrfile
       #pragma hdrfile "filename.CSM"
       hdrfile pragma用于指定预编译头文件的名称。前提是必须已启用预编译头文件功能。

10．#pragma hdrstop
#pragma hdrstop
hdrstop pragma用于终止若干个头文件的预编译，可有效减少预编译头文件占用的磁盘空间。
凡在源文件中#pragma hdrstop指令之前被引用的头文件都将被预编译成预编译头文件。假如一个头文件同时被多个源文件引用，那么生成的预编译头文件同样可被多个源文件共享。因此，在工程中#pragma hdrstop指令之前包含通用头文件可获得更好的编译性能。
例如，一个新应用程序创建后，源文件“Unit1.cpp”都会包含类似内容：
#include <vcl.h>       // common header file
#pragma hdrstop       // terminate list here
#include "Unit1.h"       // specific header file
#pragma hdrstop指令只能在源文件中使用，头文件中使用没有任何效果。
 
11．#pragma inline
#pragma inline
该指令等同于“-B”命令行选项。.
#pragma inline指令最好放在源文件的顶部，因为编译器每次遇到#pragma inline指令都会加上“-B”命令行选项重新编译该文件。
12．#pragma intrinsic
#pragma intrinsic [-]function-name
＃pragma intrinsic用于重写控制函数内联的命令行开关或IDE选项。
内联一个指定的函数前必须包含该函数的原型。
例如：
#pragma intrinsic strcpy
编译器将在调用strcpy函数的函数内产生strcpy函数实现代码。
#pragma intrinsic –strcpy
阻止编译器对strcpy内联。
13．#pragma link
#pragma link “[path]modulename[.ext]”
该指令命令连接器将一个文件连接到可执行文件中。缺省情况下，连接器缺省在本地路径下查找modulename文件，modulename文件后缀为“.obj”。使用命令行选项“-L”或者path参数指定任意路径。
14．#pragma message
#pragma message ("text" ["text"["text" ...]])
#pragma message text
#pragma message (text)
使用这三个指令用于在程序代码中显示自定义的消息。
第一个指令用于输出一个消息，其中的宏不被展开。
第二个指令用于输出一个包含宏的消息，其中的宏将被展开。
第三个指令用于展开并输出一个已定义的宏。如果宏未被定义，将输出一个该指令无效的消息。
例如：
#ifdef __BORLANDC__
#pragma message you are compiling using version __BORLANDC__ of C++Builder.
#else
#pragma message “sorry,you are not using C++Builder compiler.”
#endif
14．#pragma obsolete
#pragma obsolete identifier
凡是在程序代码中该指令后遇到identifier标识符，预编译器将第一时间给出一个警告信息。警告显示该标识符已作废。
15．#pragma option
       #pragma option options
#pragma option push options
#pragma option pop
#pragma nopushoptwarn
使用#pragma option指令用于在程序代码中包含命令行选项。#pragma option指令也可以附加push 和 pop参数后使用。
大部分命令行选项都可以作为options参数使用。options参数允许同时包含多个命令行选项。例如：
#pragma option -C
#pragma option -C –A
使用#pragma option push指令可以保存当前所有的命令行选项。#pragma option pop指令和#pragma option push指令配对使用，用于恢复以前保存的命令行选项。例如：
#pragma option push
#include <theworld.h>
#pragma option pop
#include “ystuff.h”
下面的实例因push和pop指令未配对使用，将会产生一个空栈警告。
#pragma option push
#pragma option pop
#pragma option pop      /* Warning */
通过#pragma warn –nop指令可以关闭这个警告。
有一点必须特别注意，必须保证每个文件中的#pragma option push和#pragma option pop指令配对使用。如果在文件结尾和文件开始时的命令行选项堆栈内容不一致，将会显示一个警告：“以前的选项和警告没有恢复？”。
通过#pragma nopushoptwarn.指令关闭这个警告。
16．#pragma pack
#pragma pack([{push | pop}[,]] [identifier[,]] [n])
#pragma pack(n)指令和#pragma option –an指令的作用是一样的。n表示编译器在内存中排列数据的字节对齐方式。
#pragma pack()表示选择编译器缺省的字节对齐方式，缺省为8字节。
#pragma pack(n)表示选择n值作为字节对齐方式。n可以为1，2，4，8和16。
#pragma pack(push) 表示压入当前字节对齐方式。
#pragma pack(push, ident) 表示关联标识符ident后压入当前字节对齐方式。
#pragma pack(push, n) 表示压入当前字节对齐方式，选择n值作为字节对齐方式。
#pragma pack(push, ident, n) 表示关联标识符ident后压入当前字节对齐方式，选择n值作为字节对齐方式。
#pragma pack(pop) 表示弹出最后压入的字节对齐方式。
#pragma pack(pop, ident) 表示弹出关联标识符ident的字节对齐方式。如果没有找到该标识符，选择缺省字节对齐方式。
#pragma pack(pop,n) 表示弹出n值大小的字节对齐方式。如果没有找到匹配的内容，选择缺省字节对齐方式。
#pragma pack(pop, ident,n) 表示弹出关联标识符ident的n值大小的字节对齐方式。如果没有找到匹配的内容，选择缺省字节对齐方式。
#pragma pop指令必须和#pragma push指令配对使用。