BCB6中的#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指令配对使用。