c++builder 中关于#pragma使用整理

c++builder 中关于#pragma使用

关于#pragma的预编译，在不同编辑器内都有所不同，这里只针对C++Builder的做一些记录。

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 asexpected。

5．#pragma codeseg

#pragma codeseg <"seg_class">

codesegpragma用于重命名函数代码所在的段（segment）、类(class)、组（group）。如果codeseg后没有任何选项，表示使用缺省代码段。

6．#pragma comment

#pragma comment (comment type, “string”)

comment pragma用于将一个comment记录写入到输出文件。Comment类型可以下列值之一：

1）exestr编译器将string写入到一个.obj文件中，最终放置到可执行文件中。使用文件搜索工具可以从可执行文件中找到该string。

2）lib 连接器将一个string中指定的.lib文件写入到一个.obj文件中。

3）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 turnedon

bcc32 -c -P -O2 -C，输出是All switches are turned on

8. #pragma exit and #pragma startup

#pragma startup function-name 

#pragma exit function-name

这两个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

hdrstop pragma用于终止若干个头文件的预编译，可有效减少预编译头文件占用的磁盘空间。

凡在源文件中#pragmahdrstop指令之前被引用的头文件都将被预编译成预编译头文件。假如一个头文件同时被多个源文件引用，那么生成的预编译头文件同样可被多个源文件共享。因此，在工程中#pragmahdrstop指令之前包含通用头文件可获得更好的编译性能。

例如，一个新应用程序创建后，源文件”Unit1.cpp”都会包含类似内容：

#include // common header file

#pragma hdrstop // terminate list here

#include “Unit1.h” // specific header file

#pragma hdrstop指令只能在源文件中使用，头文件中使用没有任何效果。

11．#pragma inline

#pragma inline，该指令等同于”-B”命令行选项。.

#pragma inline指令最好放在源文件的顶部，因为编译器每次遇到#pragmainline指令都会加上”-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__ ofC++Builder.

#else

#pragma message “sorry,you are not using C++Buildercompiler.”

#endif

15．#pragma obsolete

#pragma obsolete identifier

凡是在程序代码中该指令后遇到identifier标识符，预编译器将第一时间给出一个警告信息。警告显示该标识符已作废。

16．#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指令和#pragmaoption push指令配对使用，用于恢复以前保存的命令行选项。例如：

#pragma option push

#include #pragma option pop

#include “ystuff.h”

下面的实例因push和pop指令未配对使用，将会产生一个空栈警告。

#pragma option push

#pragma option pop

#pragma option pop

通过#pragma warn -nop指令可以关闭这个警告。

有一点必须特别注意，必须保证每个文件中的#pragma option push和#pragma optionpop指令配对使用。如果在文件结尾和文件开始时的命令行选项堆栈内容不一致，将会显示一个警告：”以前的选项和警告没有恢复？”。通过#pragma nopushoptwarn.指令关闭这个警告。

17．#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指令配对使用。