首页 > 代码库 > 总结一下#pragma的用法

总结一下#pragma的用法

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

1.message 参数

  Message 参数能够在编译信息输出窗口中输出相应的信息,这对于 源代码信息的控制是非常重要的。其使用方法为:
 
  #pragma message(“消息文本”)
 
  当 编译器遇到这条指令时就在编译输出窗口中将消息文本打印出来。
 
  当我们在程序中定义了许多宏来控制源代码版本的时候,我们自己有可能都会忘记有没有正确的设置这些宏,此时我们可以用这条指令在编译的时候就进行检查。假设我们希望判断自己有没有在源代码的什么地方定义了_X86这个宏可以用下面的方法
 
  #ifdef _X86
 
  #pragma message(“_X86 macro activated!”)
 
  #endif
 
  当我们定义了_X86这个宏以后, 应用程序在编译时就会在编译输出窗口里显示“_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中包括 窗体外观的定义。

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(...)
 
  该指令将一个注释记录放入一个对象文件或可执行文件
 
  常用的lib关键字,可以帮我们连入一个 库文件。
 
  每个编译程序可以用 #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是一个预定义的 标识符,指定注释的类型,应该是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 = http://www.mamicode.com/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
引用一个特殊的软件中断作为函数名称把软中断的调用作为函数来调用,因为函数的名字 就是 软中断的 别名。