#pragma详细解释(一)

简介:

#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字节对齐方式

指定连接要使用的库 比如我们连接的时候用到了 WSock32.lib,你当然可以不辞辛苦地把它加入到你的工程中。但是我觉得更方便的方法是使用 #pragma 指示符,指定要连接的库: #pragma comment(lib, "WSock32.lib")

附加:

每种C和C++的实现支持对其宿主机或操作系统唯一的功能。例如,一些程序需要精确控制超出数据所在的储存空间,或着控制特定函数接受参数的方式。#pragma指示使每个编译程序在保留C和C++语言的整体兼容性时提供不同机器和操作系统特定的功能。编译指示被定义为机器或操作系统特定的,并且通常每种编译程序是不同的。
语法:
#pragma token_string
“token_string”是一系列字符用来给出所需的特定编译程序指令和参数。数字符号“#”必须是包含编译指令的行中第一个非空白字符;而空白字符可以隔开数字符号“#”和关键字“pragma”。在#pragma后面,写任何翻译程序能够作为预处理符号分析的文本。#pragma的参数类似于宏扩展。
如果编译程序发现它不认得一个编译指示,它将给出一个警告,可是编译会继续下去。
为了提供新的预处理功能,或者为编译程序提供由实现定义的信息,编译指示可以用在一个条件语句内。C和C++编译程序可以识别下列编译程序指令。
alloc_text comment init_seg* optimize
auto_inline component inline_depth pack
bss_seg data_seg inline_recursion pointers_to_members*
check_stack function intrinsic setlocale
code_seg hdrstop message vtordisp*
const_seg include_alias once warning
*仅用于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编译指示

 

编译指示
用/Gs选项编译?
行为
#pragma check_stack()或#pragmacheck_stack
后续的函数关闭堆栈检查
#pragma check_stack()或#pragmacheck_stack
后续的函数打开堆栈检查
#pragma check_stack(on)或#pragmacheck_stack(+)
是或者否
后续的函数打开堆栈检查
#pragma check_stack(off)或#pragmacheck_stack(-)
是或者否
后续的函数关闭堆栈检查

 

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参数包含描述的文本。该描述记录将被连接程序忽略。

 

下面的编译指示导致连接程序在连接时搜索EMAPI.LIB库。连接程序首先在当前工作目录然后在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__ )
 

#pragma详细解释(二) 

2010-04-18 14:22:00|  分类: 默认分类 |  标签: |字号订阅

 
 
8  component
#pragma component( browser, { on | off }[, references [, name ]] )
#pragma component( minrebuild, on | off )
 
从源文件内控制浏览信息和依赖信息的收集。

8-1  浏览信息(Browser)

你可以将收集打开或关闭,你也可以指定收集时忽略特别的名字。
使用on或off在编译指示以后控制浏览信息的收集。例如:
#pragma component(browser, off)
终止编译程序收集浏览信息。
注意,为了用这个编译指示打开浏览信息的收集,必须先从Project Setting对话框或者命令行允许浏览信息。
references选项可以有也可以没有name参数。使用没有name参数的references选项将打开或者关闭引用信息的收集(然而继续收集其它浏览信息)。例如:
#pragma component(browser, off, references)
终止编译程序收集引用信息。
使用有name和off参数的references选项将阻止从浏览信息窗口中出现引用到的名字。用这个语法将忽略你不感兴趣的名字和类型从而减少浏览信息文件的大小。例如:
#pragma component(browser, off, references, DWORD)
从这一点以后忽略DWORD的引用。你能够用on恢复DWORD的引用收集:
#pragma component(browser, on, references, DWORD)
这是唯一的方法可以恢复收集指定名字的引用,你必须显式地打开任何你关闭的名字。
为了防止预处理程序扩展名字(就像扩展NULL到0),用引号括起来:
#pragma component(browser, off, references, "NULL")

8-2  最小化重建(Minimal Rebuild)

Visual C++的最小化重建功能要求编译程序创建并保存需要大量磁盘空间的C++类依赖信息。为了节省磁盘空间,你能够在你不需要收集依赖信息时使用#pragma component(minrebuild,off),例如,没有改变过头文件。在未修改过的类之后插入#pragma component(minrebuild,on)重新打开依赖信息。
详见Enable Minimal Rebuild(/Gm)编译程序选项。

9  data_seg

#pragma data_seg( ["section-name"[, "section-class"] ] )
指定数据的默认段。例如:
#pragma data_seg( "MY_DATA" )
导致在#pragma语句后分配的数据保存在一个叫做MY_DATA的段中。
用data_seg编译指示分配的数据不包含任何关于其位置的信息。
第二个参数section-class是用于兼容2.0版本以前的Visual C++的,现在将忽略它。

10  function

#pragma function( function1 [, function2, ...] )
指定必须生成对编译指示中参数列表内函数的调用。如果你使用intrinsic编译指示(或者/Oi)来告诉编译程序生成内含函数(内含函数如同嵌入代码一样生成,不作为一个函数调用),你能够用function编译指示显式地强迫函数调用。当遇到一个function编译指示,它将在其后面遇到的第一个包含有内含函数的函数定义处生效。其持续作用到源文件的尾部或者出现对同一个内含函数指定intrinsic编译指示。function编译指示只能用于函数外——在全局层次。
为了列出具有内含形式的函数表,参见#pragma intrinsic。

11  hdrstop

#pragma hdrstop [( "filename" )]
控制预编译头文件的工作方式。filename是要使用或者创建(依赖于是否指定了/Yu或/Yc)预编译头文件的名字。如果 filename不包括一个指定路径,将假定预编译头文件和源文件处于同一个目录中。当指定自动预编译头文件选项/YX时,所有指定的文件名将被忽略。
相关文章
|
26天前
|
安全 编译器 C语言
深入理解C/C++预处理器指令#pragma once以及与ifndef的比较
深入理解C/C++预处理器指令#pragma once以及与ifndef的比较
26 0
|
3月前
|
编译器
头文件ifndef用法及意义#pragma once
头文件ifndef用法及意义#pragma once
18 0
|
4月前
|
编译器 程序员 C++
[C++] #ifndef和#define与#pragma once在头文件中的作用和关系
[C++] #ifndef和#define与#pragma once在头文件中的作用和关系
29 0
|
10月前
|
编译器 C语言
宏、条件编译(#ifdef)、#include(头文件包含)、#error和 #pragma的区别、#和##的含义和应用
宏、条件编译(#ifdef)、#include(头文件包含)、#error和 #pragma的区别、#和##的含义和应用
#pragma的一些用法
1、#pragma message message 参数:Message参数能够在编译信息输出窗口输出相应的信息,这对于源代码的信息控制特别重要,其使用方法为: #pragma message("消息文本") 当我们程序中定义了许多宏来控制源代码版本的时候,我们自己都有可能会忘记有没有正确设置...
1078 0