2024年3月11日发(作者：极米投影仪)

#pragma详细解释(一）

默认分类 2010-04-18 14:21:00 阅读151 评论0 字号：大中小 订阅

在#Pragma是预处理指令它的作用是设定编译器的状态或者是指示编译器完成一些特定的

动作。#pragma指令对每个编译器给出了一个方法,在保持与C和C ++语言完全兼容的情

况下,给出主机或操作系统专有的特征。依据定义,编译指示是机器

或操作系统专有的,且对于每个编译器都是不同的。

其格式一般为: #Pragma Para

其中Para 为参数，下面来看一些常用的参数。

(1)message 参数。 Message 参数是我最喜欢的一个参数，它能够在编译信息输出窗

口中输出相应的信息，这对于源代码信息的控制是非常重要的。其使用方法为：

#Pragma message(“消息文本”)

当编译器遇到这条指令时就在编译输出窗口中将消息文本打印出来。

当我们在程序中定义了许多宏来控制源代码版本的时候，我们自己有可能都会忘记有没有正

确的设置这些宏，此时我们可以用这条指令在编译的时候就进行检查。假设我们希望判断自

己有没有在源代码的什么地方定义了_X86这个宏可以用下面的方法

#ifdef _X86

#Pragma message(“_X86 macro activated!”)

#endif

当我们定义了_X86这个宏以后，应用程序在编译时就会在编译输出窗口里显示“_

X86 macro activated!”。我们就不会因为不记得自己定义的一些特定的宏而抓耳挠腮了。

(2)另一个使用得比较多的pragma参数是code_seg。格式如：

#pragma code_seg( [section-name[,section-class] ] )

它能够设置程序中函数代码存放的代码段，使用没有section-name字符串的

#pragmacode_seg可在编译开始时将其复位，当我们开发驱动程序的时候就会使用到它。

(3)#pragma once (比较常用）

只要在头文件的最开始加入这条指令就能够保证头文件被编译一次，这条指令实际上在

VC6

中就已经有了，但是考虑到兼容性并没有太多的使用它。

(4)#pragma hdrstop表示预编译头文件到此为止，后面的头文件不进行预编译。BCB可以

预

编译头文件以加快链接的速度，但如果所有头文件都进行预编译又可能占太多磁盘空间，所

以使用这个选项排除一些头文件。

有时单元之间有依赖关系，比如单元A依赖单元B，所以单元B要先于单元A编译。你可

以用#p

ragma startup指定编译优先级，如果使用了#pragma package(smart_init) ，BCB就会根

据优先级的大小先后编译。

(5)#pragma resource *.dfm表示把*.dfm文件中的资源加入工程。*.dfm中包括窗体

外观的定义。

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

等价于：

#pragma warning(disable:4507 34) // 不显示4507和34号警告信息

#pragma warning(once:4385) // 4385号警告信息仅报告一次

#pragma warning(error:164) // 把164号警告信息作为一个错误。

同时这个pragma warning 也支持如下格式：

#pragma warning( push [ ,n ] )

#pragma warning( pop )

这里n代表一个警告等级(1---4)。

#pragma warning( push )保存所有警告信息的现有的警告状态。

#pragma warning( push, n)保存所有警告信息的现有的警告状态，并且把全局警告

等级设定为n。

#pragma warning( pop )向栈中弹出最后一个警告信息，在入栈和出栈之间所作的

一切改动取消。例如：

#pragma warning( push )

#pragma warning( disable : 4705 )

#pragma warning( disable : 4706 )

#pragma warning( disable : 4707 )

//.......

#pragma warning( pop )

在这段代码的最后，重新保存所有的警告信息(包括4705，4706和4707)。

（7）pragma comment(...)

该指令将一个注释记录放入一个对象文件或可执行文件中。

常用的lib关键字，可以帮我们连入一个库文件。

（8）·通过#pragma pack(n)改变C编译器的字节对齐方式

在C语言中，结构是一种复合数据类型，其构成元素既可以是基本数据类型（如int、

long、float等）的变量，也可以是一些复合数据类型（如数组、结构、联合等）的

数据单元。在结构中，编译器为结构的每个成员按其自然对界（alignment）条件分

配空间。各个成员按照它们被声明的顺序在内存中顺序存储，第一个成员的地址和

整个结构的地址相同。

例如，下面的结构各成员空间分配情况：

struct test

{

char x1;

short x2;

float x3;

char x4;

};

结构的第一个成员x1，其偏移地址为0，占据了第1个字节。第二个成员x2为

short类型，其起始地址必须2字节对界，因此，编译器在x2和x1之间填充了一个

空字节。结构的第三个成员x3和第四个成员x4恰好落在其自然对界地址上，在它

们前面不需要额外的填充字节。在test结构中，成员x3要求4字节对界，是该结构

所有成员中要求的最大对界单元，因而test结构的自然对界条件为4字节，编译器

在成员x4后面填充了3个空字节。整个结构所占据空间为12字节。更改C编译器的

缺省字节对齐方式

在缺省情况下，C编译器为每一个变量或是数据单元按其自然对界条件分配

空间。一般地，可以通过下面的方法来改变缺省的对界条件：

· 使用伪指令#pragma pack (n)，C编译器将按照n个字节对齐。

· 使用伪指令#pragma pack ()，取消自定义字节对齐方式。

另外，还有如下的一种方式：

· __attribute((aligned (n)))，让所作用的结构成员对齐在n字节自然边界上。

如果结构中有成员的长度大于n，则按照最大成员的长度来对齐。

· __attribute__ ((packed))，取消结构在编译过程中的优化对齐，按照实际

占用字节数进行对齐。

以上的n = 1, 2, 4, 8, 16... 第一种方式较为常见。

应用实例

在网络协议编程中，经常会处理不同协议的数据报文。一种方法是通过指针偏移的

方法来得到各种信息，但这样做不仅编程复杂，而且一旦协议有变化，程序修改起来

也比较麻烦。在了解了编译器对结构空间的分配原则之后，我们完全可以利用这

一特性定义自己的协议结构，通过访问结构的成员来获取各种信息。这样做，

不仅简化了编程，而且即使协议发生变化，我们也只需修改协议结构的定义即可，

其它程序无需修改，省时省力。下面以TCP协议首部为例，说明如何定义协议结构。

其协议结构定义如下：

#pragma pack(1) // 按照1字节方式进行对齐

struct TCPHEADER

{

short SrcPort; // 16位源端口号

short DstPort; // 16位目的端口号

int SerialNo; // 32位序列号

int AckNo; // 32位确认号

unsigned char HaderLen : 4; // 4位首部长度

unsigned char Reserved1 : 4; // 保留6位中的4位

unsigned char Reserved2 : 2; // 保留6位中的2位

unsigned char URG : 1;

unsigned char ACK : 1;

unsigned char PSH : 1;

unsigned char RST : 1;

unsigned char SYN : 1;

unsigned char FIN : 1;

short WindowSize; // 16位窗口大小

short TcpChkSum; // 16位TCP检验和

short UrgentPointer; // 16位紧急指针

};

#pragma pack() // 取消1字节对齐方式

指定连接要使用的库

比如我们连接的时候用到了 ，你当然可以不辞辛苦地把它加入到你的工程中。

但是我觉得更方便的方法是使用 #pragma 指示符，指定要连接的库:

#pragma comment(lib, "")

附加：

每种C和C++的实现支持对其宿主机或操作系统唯一的功能。例如，一些程序需

要精确控制超出数据所在的储存空间，或着控制特定函数接受参数的方式。

#pragma指示使每个编译程序在保留C和C++语言的整体兼容性时提供不同机器

和操作系统特定的功能。编译指示被定义为机器或操作系统特定的，并且通常每

种编译程序是不同的。

语法：

#pragma token_string

“token_string”是一系列字符用来给出所需的特定编译程序指令和参数。数字符号“#”

必须是包含编译指令的行中第一个非空白字符；而空白字符可以隔开数字符号“#”

和关键字“pragma”。在#pragma后面，写任何翻译程序能够作为预处理符号分析的

文本。#pragma的参数类似于宏扩展。

如果编译程序发现它不认得一个编译指示，它将给出一个警告，可是编译会继续

下去。

为了提供新的预处理功能，或者为编译程序提供由实现定义的信息，编译指示可

以用在一个条件语句内。C和C++编译程序可以识别下列编译程序指令。

alloc_text

auto_inline

bss_seg

check_stack

code_seg

comment

component

data_seg

function

hdrstop

init_seg*

inline_depth

inline_recursion

intrinsic

message

once

optimize

pack

pointers_to_members*

setlocale

vtordisp*

warning const_seg include_alias

*仅用于C++编译程序。

1 alloc_text

#pragma alloc_text( "textsection", function1, ... )

命名特别定义的函数驻留的代码段。该编译指示必须出现在函数说明符和函数定

义之间。

alloc_text编译指示不处理C++成员函数或重载函数。它仅能应用在以C连接方式

说明的函数——就是说，函数是用extern "C"连接指示符说明的。如果你试图将这

个编译指示应用于一个具有C++连接方式的函数时，将出现一个编译程序错误。

由于不支持使用__based的函数地址，需要使用alloc_text编译指示来指定段位置。

由textsection指定的名字应该由双引号括起来。

alloc_text编译指示必须出现在任何需要指定的函数说明之后，以及这些函数的定

义之前。

在alloc_text编译指示中引用的函数必须和该编译指示处于同一个模块中。如果

不这样做，使以后一个未定义的函数被编译到一个不同的代码段时，错误会也可

能不会被捕获。即使程序一般会正常运行，但是函数不会分派到应该在的段。

alloc_text的其它限制如下：

它不能用在一个函数内部。

它必须用于函数说明以后，函数定义以前。

2 auto_inline

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

当指定off时将任何一个可以被考虑为作为自动嵌入扩展候选的函数排除出该范

围。为了使用auto_inline编译指示，将其紧接着写在一个函数定义之前或之后（不

是在其内部）。该编译指示将在其出现以后的第一个函数定义开始起作用。

auto_inline编译指示对显式的inline函数不起作用。

3 bss_seg

#pragma data_seg( ["section-name"[, "section-class"] ] )

为未初始化数据指定缺省段。data_seg编译指示除了工作于已初始化数据而不是

未初始化的以外具有一样的效果。在一些情况下，你能使用bss_seg将所有未初

始化数据安排在一个段中来加速你的装载时间。

#pragma bss_seg( "MY_DATA" )

将导致把#pragma语句之后的未初始化的数据安排在一个叫做MY_DATA的段中。

用bss_seg编译指示分配的数据不包含任何关于其位置的信息。

第二个参数section-class是用于兼容2.0版本以前的Visual C++的，现在将忽略它。

4 check_stack

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

#pragma check_stack{+ | –}

如果指定off（或者“-”）指示编译程序关闭堆栈探测，或者指定on（或“+”）打开

堆栈探测。如果没有给出参数，堆栈探测将根据默认设置决定。该编译指示将在

出现该指示之后的第一个函数开始生效。堆栈探测既不是宏和能够生成嵌入代码

函数的一部分。

如果你没有给出check_stack编译指示的参数，堆栈检查将恢复到在命令行指定的

行为。详细情况见编译程序参考。#pragma check_stack和/Gs选项的互相作用情况

在表2.1中说明。

表 2.1 使用check_stack编译指示

编译指示

#pragma check_stack()或

#pragma check_stack

#pragma check_stack()或

#pragma check_stack

#pragma check_stack(on)或

#pragma check_stack(+)

#pragma check_stack(off)或

#pragma check_stack(-)

用/Gs选项编译？

是

否

是或者否

是或者否

查

行为

后续的函数关闭堆栈检

后续的函数打开堆栈检

查

后续的函数打开堆栈检

查

后续的函数关闭堆栈检

查

5 code_seg

#pragma code_seg( ["section-name"[,"section-class"] ] )

指定分配函数的代码段。code_seg编译指示为函数指定默认的段。你也能够像段

名一样指定一个可选的类名。使用没有段名字符串的#pragma code_seg将恢复分

配到编译开始时候的状态。

6 const_seg

#pragma const_seg( ["section-name"[, "section-class"] ] )

指定用于常量数据的默认段。data_seg编译指示除了可以工作于所有数据以外具

有一样的效果。你能够使用该编译指示将你的常量数据保存在一个只读的段中。

#pragma const_seg( "MY_DATA" )

导致在#pragma语句后面的常量数据分配在一个叫做MY_DATA的段中。

用const_seg编译指示分配的数据不包含任何关于其位置的信息。

第二个参数section-class是用于兼容2.0版本以前的Visual C++的，现在将忽略它。

7 comment

#pragma comment( comment-type [, commentstring] )

将描述记录安排到目标文件或可执行文件中去。comment-type是下面说明的五个

预定义标识符中的一个，用来指定描述记录的类型。可选的commentstring是一个

字符串文字值用于为一些描述类型提供附加的信息。因为commentstring是一个字

符串文字值，所以它遵从字符串文字值的所有规则，例如换码字符、嵌入的引号

（"）和联接。

7-1 compiler

在目标文件中放置编译程序名和版本号。该描述记录被连接程序忽略。如果你为

这个记录类型提供一个commentstring参数，编译程序将生成一个警告。

7-2 exestr

将commentstring放置到目标文件中去。在连结时，这个字符串再被放到可执行文

件去中。当可执行文件被装载时这个字符串不会被装入内存，然而，它可以被一

个能够在文件中搜索可打印字符串的程序找到。该描述记录的一个用处是在可执

行文件中嵌入版本号或者类似的信息。

7-3 lib

将一个库搜索记录放置到目标文件中去。该描述类型必须有包含你要连接程序搜

索的库名（和可能的路径）的commentstring参数。因为在目标文件中该库名先于

默认的库搜索记录，所以连接程序将如同你在命令行输入这些库一样来搜索它们。

你可以在一个源文件中放置多个库搜索记录，每个记录将按照它们出现在源文件

中的顺序出现在目标文件中。

7-4 linker

在目标文件中放置连接程序选项。你可以用这个描述类型指定连接程序选项来代

替在Project Setting对话框中Link页内的选项。例如，你可以指定/include选项以强

迫包含一个符号：

#pragma comment(linker, "/include:__mySymbol")

7-5 user

在目标文件中包含一个普通描述记录。commentstring参数包含描述的文本。该描

述记录将被连接程序忽略。

下面的编译指示导致连接程序在连接时搜索库。连接程序首先在当前

工作目录然后在LIB环境变量指定的路径中搜索。

#pragma comment( lib, "emapi" )

下面的编译指示导致编译程序将其名字和版本号放置到目标文件中去。

The following pragma causes the compiler to place the name and version number of

the compiler in the object file:

#pragma comment( compiler )

注意，对于具有commentstring参数的描述记录，你可以使用其它用作字符串文字

量的宏来提供宏扩展为字符串文字量。你也能够联结任何字符串文字量和宏的组

合来扩展成为一个字符串文字量。例如，下面的语句是可以接受的：

#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )