#Pragma 用法总结

比眉伴天荒 2024-04-19 14:12 48阅读 0赞

#### 百科名片   **http://baike.baidu.com/view/1451188.htm** ####

在所有的预处理指令中，\#Pragma 指令可能是最复杂的了，它的作用是设定[编译器][Link 1]的状态或者是指示编译器完成一些特定的动作。\#pragma指令对每个编译器给出了一个方法,在保持与C和C++语言完全兼容的情况下,给出主机或[操作系统][Link 2]专有的特征。依据定义,编译指示是机器或操作系统专有的,且对于每个编译器都是不同的。

### 1.message 参数 ###

Message 参数能够在编译信息输出窗口中输出相应的信息，这对于 [源代码][Link 3]信息的控制是非常重要的。其使用方法为：

\#pragma message(“消息文本”)

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

当我们在程序中定义了许多宏来控制源代码版本的时候，我们自己有可能都会忘记有没有正确的设置这些宏，此时我们可以用这条指令在编译的时候就进行检查。假设我们希望判断自己有没有在源代码的什么地方定义了\_X86这个宏可以用下面的方法

\#ifdef \_X86

\#pragma message(“\_X86 macro activated!”)

\#endif

当我们定义了\_X86这个宏以后， [应用程序][Link 4]在编译时就会在编译输出窗口里显示“\_X86 macro activated!”。我们就不会因为不记得自己定义的一些特定的宏而抓耳挠腮了。

### 2.code\_seg ###

另一个使用得比较多的pragma参数是code\_seg。格式如：

\#pragma code\_seg( \["section-name"\[,"section-class"\] \] )

它能够 **设置程序中函数代码存放的代码段，当我们开发驱动程序的时候就会使用到它**。

### 3.\#pragma once ###

(比较常用）

**只要在头文件的最开始加入这条指令就能够保证头文件被编译一次**，这条指令实际上在VC6中就已经有了，但是考虑到兼容性并没有太多的使用它。

**\#pragma once是编译相关，就是说这个编译系统上能用，但在其他编译系统不一定可以，也就是说移植性差，不过现在基本上已经是每个编译器都有这个定义了**。

\#ifndef，\#define，\#endif这个是C++语言相关，这是 **C++语言中的宏定义，通过宏定义避免文件多次编译**。所以在所有支持C++语言的编译器上都是有效的，如果写的程序要跨平台，最好使用这种方式

### 4.\#pragma hdrstop ###

\#pragma hdrstop表示预编译头文件到此为止，后面的头文件不进行预编译。BCB可以预编译头文件以加快链接的速度，但如果所有头文件都进行预编译又可能占太多磁盘空间，所以使用这个选项排除一些头文件。

有时单元之间有依赖关系，比如单元A依赖单元B，所以单元B要先于单元A编译。你可以用\#pragma startup指定编译优先级，如果使用了\#pragma package(smart\_init) ，BCB就会根据优先级的大小先后编译。

### 5.\#pragma resource ###

\#pragma resource "\*.dfm"表示把\*.dfm文件中的资源加入工程。\*.dfm中包括 [窗体][Link 5]外观的定义。

### 6.\#pragma warning ###

\#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 ###

**　pragma comment(...)**

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

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

每个编译程序可以用 **\#pragma指令激活或终止该编译程序支持的一些编译功能**。例如，对循环优化功能：

\#pragma loop\_opt(on) // 激活

\#pragma loop\_opt(off) // 终止

有时，程序中会有些函数会使编译器发出你熟知而想忽略的警告，如“Parameter xxx is never used in function xxx”，可以这样：

\#pragma warn —100 // Turn off the warning message for warning \#100

int insert\_record(REC \*r)

\{ /\* function body \*/ \}

\#pragma warn +100 // Turn the warning message for warning \#100 back on

函数会产生一条有唯一特征码100的警告信息，如此可暂时终止该警告。

每个编译器对\#pragma的实现不同，在一个编译器中有效在别的编译器中几乎无效。可从编译器的文档中查看。

\#pragma pack(n)和\#pragma pop()

struct sample

char a;

double b;

\};

当sample结构没有加\#pragma pack(n)的时候,sample按最大的成员那个对齐;

（所谓的对齐是指对齐数为n时,对每个成员进行对齐,既如果成员a的大小小于n则将a扩大到n个大小;

如果a的大小大于n则使用a的大小;）所以上面那个结构的大小为16字节.

当sample结构加\#pragma pack(1)的时候,sizeof(sample)=9字节;无空字节。

（另注：当n大于sample结构的最大成员的大小时，n取最大成员的大小。

所以当n越大时，结构的速度越快，大小越大；反之则）

\#pragma pop()就是取消\#pragma pack(n)的意思了，也就是说接下来的结构不用\#pragma pack(n)

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

comment-type是一个预定义的 [标识符][Link 8]，指定注释的类型，应该是compiler，exestr，lib，linker之一。

commentstring是一个提供为comment-type提供附加信息的字符串。

注释类型：

1、compiler：

放置编译器的版本或者名字到一个对象文件，该选项是被linker忽略的。

2、exestr：

在以后的版本将被取消。

3、lib：

放置一个库搜索记录到对象文件中，这个类型应该是和commentstring（指定你要Linker搜索的lib的名称和路径）这个库的名字放在Object文件的默认库搜索记录的后面，linker搜索这个这个库就像你在命令行输入这个命令一样。你可以在一个源文件中设置多个库记录，它们在object文件中的顺序和在源文件中的顺序一样。如果默认库和附加库的次序是需要区别的，使用Z编译开关是防止默认库放到object模块。

4、linker：

指定一个连接选项，这样就不用在命令行输入或者在开发环境中设置了。

只有下面的linker选项能被传给Linker.

/DEFAULTLIB ,/EXPORT,/INCLUDE,/MANIFESTDEPENDENCY, /MERGE,/SECTION

(1) /DEFAULTLIB:library

/DEFAULTLIB 选项将一个 library 添加到 LINK 在解析引用时搜索的库列表。用 /DEFAULTLIB指定的库在命令行上指定的库之后和 .obj 文件中指定的默认库之前被搜索。忽略所有默认库 (/NODEFAULTLIB) 选项重写 /DEFAULTLIB:library。如果在两者中指定了相同的 library 名称，忽略库 (/NODEFAULTLIB: *library*) 选项将重写 /DEFAULTLIB: *library*。

(2)/EXPORT: *entryname*\[,@ *ordinal*\[,NONAME\]\]\[,DATA\]

使用该选项，可以从程序导出函数，以便其他程序可以调用该函数。也可以导出数据。通常在 DLL 中定义导出。 *entryname*是调用程序要使用的函数或数据项的名称。ordinal 在导出表中指定范围在 1 至 65,535 的索引；如果没有指定 ordinal，则 LINK 将分配一个。 **NONAME**关键字只将函数导出为序号，没有 *entryname*。

**DATA** 关键字指定导出项为数据项。客户程序中的数据项必须用 **extern \_\_declspec(dllimport)**来声明。

有三种导出定义的方法，按照建议的使用顺序依次为：

源代码中的 \_\_declspec(dllexport).def 文件中的 EXPORTS 语句LINK 命令中的 /EXPORT 规范所有这三种方法可以用在同一个程序中。LINK 在生成包含导出的程序时还创建导入库，除非生成中使用了 .exp 文件。

LINK 使用标识符的修饰形式。编译器在创建 .obj 文件时修饰标识符。如果 *entryname*以其未修饰的形式指定给链接器（与其在源代码中一样），则 LINK 将试图匹配该名称。如果无法找到唯一的匹配名称，则 LINK 发出错误信息。当需要将标识符指定给链接器时，请使用 Dumpbin 工具获取该标识符的修饰名形式。

(3)/INCLUDE:symbol

/INCLUDE 选项通知链接器将指定的符号添加到符号表。

若要指定多个符号，请在符号名称之间键入逗号 (,)、分号 (;) 或空格。在命令行上，对每个符号指定一次 /INCLUDE:symbol。

链接器通过将包含符号定义的对象添加到程序来解析 symbol。该功能对于添包含不会链接到程序的库对象非常有用。用该选项指定符号将通过 /OPT:REF 重写该符号的移除。

我们经常用到的是\#pragma comment（lib，"\*.lib"）这类的。\#pragma comment(lib,"Ws2\_32.lib")表示链接Ws2\_32.lib这个库。 和在工程设置里写上链入Ws2\_32.lib的效果一样，不过这种方法写的 程序别人在使用你的代码的时候就不用再设置工程settings了

### 8.\#pragma data\_seg ###

\#pragma data\_seg介绍 \[1\]

用\#pragma data\_seg建立一个新的数据段并定义共享数据，其具体格式为：

\# **pragma data\_seg** （"shareddata")

HWND sharedwnd=NULL;//共享数据

\# **pragma data\_seg()**

-----------------------------------------------------------------

1，\#pragma data\_seg()一般用于DLL中。也就是说，在DLL中定义一个共享的有名字的数据段。最关键的是：这个数据段中的全局变量可以被多个进程共享,否则多个进程之间无法共享DLL中的全局变量。

2，共享数据必须初始化，否则微软编译器会把没有初始化的数据放到.BSS段中，从而导致多个进程之间的共享行为失败。例如，

\#pragma data\_seg("MyData")

int g\_Value; // Note that the global is not initialized.

\#pragma data\_seg()

DLL提供两个接口函数：

int GetValue()

return g\_Value;

void SetValue(int n)

g\_Value = n;

然后启动两个进程A和B，A和B都调用了这个DLL，假如A调用了SetValue(5); B接着调用int m = GetValue(); 那么m的值不一定是5，而是一个未定义的值。因为DLL中的全局数据对于每一个调用它的进程而言，是私有的，不能共享的。假如你对g\_Value进行了初始化，那么g\_Value就一定会被放进MyData段中。换句话说，如果A调用了SetValue(5); B接着调用int m = GetValue(); 那么m的值就一定是5，这就实现了跨进程之间的数据通信。

**\#pragma CODE\_SECTION**

由于在基于DSP的嵌入式系统开发中，存储资源特别是片内高速存储资源有限，在算法系统集成时Memory的管理对于提高整个系统的优化是非常重要的，这一方面影响数据的读取、搬移速度；另一方面还影响Cache的命中率，下面分程序和数据两方面分析。  
        程序区：**最大原则是将经常调度使用的算法模块放片内**。为做到这点，**TI的CCS中提供了\#pragma CODE\_SECTION**，可以把需要**单独控制存放的函数段从.text段中独立出来，从而在.cmd文件中对这些函数段进行单独物理地址映射**。还可以使用**程序动态的方式**，将需要运行的代码段先调度进片内memory，如H.264/AVC中CAVLC和CABAC两个算法模块具有互斥性，因此可以将这两个算法模块放在片外而且对应于片内同一块运行区，在运行其中某一个算法模块之前，先将其调入片内，从而**充分利用片内有限的高速存储区**。程序区的管理考虑到一级程序Cache(L1 P)的命中率，最好**将具有先后执行顺序的函数按地址先后顺序配置在程序空间中，同时对代码比较大的处理函数将其拆分成小函数**。

数据区：在视频标准编解码中，由于数据块都很大，如一帧D1 4:2:0的图像有622k大小，而且在编解码中都需要开3~5帧甚至更多的缓冲帧，因此数据基本上无法在片内存放。为此在系统的Memory优化管理中，需要开C64系列DSP的二级Cache(对于TMS320DM642用于视频编解码中二级Cache开64k的情况比较多)。同时最好将放片外的被Cache所映射的视频缓冲区的数据以128 byte对齐，这是因为C64系列的DSP的二级Cache的每行大小为128 byte，以128 byte对齐有利于Cache的刷新和一致性维护。

**TI CCS:Pragma编译指示伪指令**

DATA\_SECTION

DUAL\_STATE  
默认的情况是 不使用-md选项  
所有的函数都支持dual-state interworking的外部连接  
假定大部分调用 不要求状态改变，所以会以不要求状态改变的方式被优化

DUAL\_STATE指令 说明这个函数经常要求状态变换。所以要求用 状态改变的方式 来优化

FUNC\_EXT\_CALLED  
如果你使用 -03 优化参数，做file-lever optimization/program-leverl optiomaziton所有的程序都在一个文件里面。  
编译器会移除所有不被main（）调用的函数。

但是，你可能有些函数 是给 手工写的汇编代码调用（不是给main调用的）

\#pragma FUNC\_EXT\_CALLED (func)

参数 funct就是被汇编调用的c函数的名字

INTERRUPT

TASK

指示一个函数 是一个任务，任务就是一个永远都不会返回的函数。典型的就是一个分派其他活动的无限循环；因为从不返回，所以 不必保存（当然也不用恢复）寄存器，这可以节省 RAM空间

SWI\_ALIAS  
引用一个特殊的软件中断作为函数名称，把软中断的调用作为函数来调用，因为函数的名字 就是 软中断的 别名。

转载于:https://my.oschina.net/alphajay/blog/62012

[Link 1]: http://baike.baidu.com/view/487018.htm
[Link 2]: http://baike.baidu.com/view/880.htm
[Link 3]: http://baike.baidu.com/view/60376.htm
[Link 4]: http://baike.baidu.com/view/330120.htm
[Link 5]: http://baike.baidu.com/view/230361.htm
[Link 6]: http://baike.baidu.com/view/159830.htm
[Link 7]: http://baike.baidu.com/view/1595059.htm
[Link 8]: http://baike.baidu.com/view/390932.htm