c++builder 中关于#pragma使用整理
2016-06-29 14:59
399 查看
[align=center]c++builder 中关于#pragma使用
[/align]
关于#pragma的预编译,在不同编辑器内都有所不同,这里只针对C++Builder的做一些记录。
W8035: The alignment is 8 bytes, the enum size is 4 bytes
该消息必须在打开编译器选项”show general messages”或编译器开关”-wmsg”后才能显示。
#pragma anon_struct on 允许编译类中内嵌的匿名结构
#pragma anon_struct off 禁止编译类中内嵌的匿名结构
例如:
#pragma anon_struct on
struct S
{
int i;
struct // Embedded anonymous struct
{
int j ;
float x ;
};
S() { i = 1; }
};
#pragma anon_struct off
#pragma argsused
int func(int a,int b)
{
++b;
return b;
}
如果不使用该pragma,编译器就会报类似”函数参数没有用到”的警告消息。
#pragma checkoption -a4 -b
如果没有设置,显示一个错误:E2471: pragma checkoption failed: options are not asexpected。
codesegpragma用于重命名函数代码所在的段(segment)、类(class)、组(group)。如果codeseg后没有任何选项,表示使用缺省代码段。
comment pragma用于将一个comment记录写入到输出文件。Comment类型可以下列值之一:
1)exestr编译器将string写入到一个.obj文件中,最终放置到可执行文件中。使用文件搜索工具可以从可执行文件中找到该string。
2)lib 连接器将一个string中指定的.lib文件写入到一个.obj文件中。
3)user 编译器将string写入到一个.obj文件中,但连接器忽略,就是说最终string不放置到可执行文件中。
#pragma undefineonoption name switch(es)
这两个pragma用于为若干个命令行开关建立一个别名(name)。除了部分负责输入的命令行开关(如-I、-L)外,大部分命令开关都可以在这两个指示符中使用。
#pragma defineonoption在别名中所有指定开关都已打开的情况下定义name。
#pragma undefineonoption在别名中所有指定开关都已打开的情况下不定义name。
例如,myfile.c文件包含下列代码:
#pragma defineonoption OPTIMIZING -O2
#ifdef OPTIMIZING
#pragma message We are optimizing with -O2
#else
#pragma message There are no optimizations turned on
#endif
bcc32 -c myfile.c,输出是There are no optimizations turned on
bcc32 -c -O2 myfile.c,输出是We are optimizing with -O2
下面是一个同时使用多个命令行开关的实例:
#define SWITCHES_ARE_OFF
#pragma undefineonoption SWITCHES_ARE_OFF -O2 -c -P -C
#ifdef SWITCHES_ARE_OFF
#pragma message At least one of the switches is not turned on
#else
#pragma message All switches are turned on
#endif
bcc32 -c myfile.c,输出是At least one of the switches is not turnedon
bcc32 -c -P -O2 -C,输出是All switches are turned on
#pragma exit function-name
这两个pragma分别用于指定在main函数调用前调用和在_exit函数调用前调用的函数。函数定义格式如下:
void func(void);
priority参数数值范围为64-255,0值级别最高。级别越高,在main函数调用前越早调用,在-exit函数调用前越晚调用。缺省级别为100。0-63级别C库保留使用。
hdrfile pragma用于指定预编译头文件的名称。前提是必须已启用预编译头文件功能。
凡在源文件中#pragmahdrstop指令之前被引用的头文件都将被预编译成预编译头文件。假如一个头文件同时被多个源文件引用,那么生成的预编译头文件同样可被多个源文件共享。因此,在工程中#pragmahdrstop指令之前包含通用头文件可获得更好的编译性能。
例如,一个新应用程序创建后,源文件”Unit1.cpp”都会包含类似内容:
#include // common header file
#pragma hdrstop // terminate list here
#include “Unit1.h” // specific header file
#pragma hdrstop指令只能在源文件中使用,头文件中使用没有任何效果。
#pragma inline指令最好放在源文件的顶部,因为编译器每次遇到#pragmainline指令都会加上”-B”命令行选项重新编译该文件。
#pragma intrinsic用于重写控制函数内联的命令行开关或IDE选项。内联一个指定的函数前必须包含该函数的原型。
例如:
#pragma intrinsic strcpy
编译器将在调用strcpy函数的函数内产生strcpy函数实现代码。
#pragma intrinsic -strcpy
阻止编译器对strcpy内联。
该指令命令连接器将一个文件连接到可执行文件中。缺省情况下,连接器缺省在本地路径下查找modulename文件,modulename文件后缀为”.obj”。使用命令行选项”-L”或者path参数指定任意路径。
#pragma message text
#pragma message (text)
使用这三个指令用于在程序代码中显示自定义的消息。
第一个指令用于输出一个消息,其中的宏不被展开。
第二个指令用于输出一个包含宏的消息,其中的宏将被展开。
第三个指令用于展开并输出一个已定义的宏。如果宏未被定义,将输出一个该指令无效的消息。例如:
#ifdef __BORLANDC__
#pragma message you are compiling using version __BORLANDC__ ofC++Builder.
#else
#pragma message “sorry,you are not using C++Buildercompiler.”
#endif
凡是在程序代码中该指令后遇到identifier标识符,预编译器将第一时间给出一个警告信息。警告显示该标识符已作废。
#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指令和#pragmaoption push指令配对使用,用于恢复以前保存的命令行选项。例如:
#pragma option push
#include #pragma option pop
#include “ystuff.h”
下面的实例因push和pop指令未配对使用,将会产生一个空栈警告。
#pragma option push
#pragma option pop
#pragma option pop
通过#pragma warn -nop指令可以关闭这个警告。
有一点必须特别注意,必须保证每个文件中的#pragma option push和#pragma optionpop指令配对使用。如果在文件结尾和文件开始时的命令行选项堆栈内容不一致,将会显示一个警告:”以前的选项和警告没有恢复?”。通过#pragma nopushoptwarn.指令关闭这个警告。
)
#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指令配对使用。
[/align]
关于#pragma的预编译,在不同编辑器内都有所不同,这里只针对C++Builder的做一些记录。
1.#pragma alignment(这个我在网上找到的,不是很理解,暂做记录)
alignment pragma用于显示一条当前内存对齐(alignment)和枚举(enum)字节大小的消息。例如:W8035: The alignment is 8 bytes, the enum size is 4 bytes
该消息必须在打开编译器选项”show general messages”或编译器开关”-wmsg”后才能显示。
2.#pragma anon_struct
#pragma anon_struct on 允许编译类中内嵌的匿名结构
#pragma anon_struct off 禁止编译类中内嵌的匿名结构
例如:
#pragma anon_struct on
struct S
{
int i;
struct // Embedded anonymous struct
{
int j ;
float x ;
};
S() { i = 1; }
};
#pragma anon_struct off
3.#pragma argsused
argsused pragma通常在定义一个函数前使用,用于屏蔽函数参数未使用的警告。例如:#pragma argsused
int func(int a,int b)
{
++b;
return b;
}
如果不使用该pragma,编译器就会报类似”函数参数没有用到”的警告消息。
4.#pragma checkoption optionstring
checkoption pragma检查optionstring中包含的选项是否已设置。例如:#pragma checkoption -a4 -b
如果没有设置,显示一个错误:E2471: pragma checkoption failed: options are not asexpected。
5.#pragma codeseg
#pragma codeseg <"seg_class">codesegpragma用于重命名函数代码所在的段(segment)、类(class)、组(group)。如果codeseg后没有任何选项,表示使用缺省代码段。
6.#pragma comment
#pragma comment (comment type, “string”)comment pragma用于将一个comment记录写入到输出文件。Comment类型可以下列值之一:
1)exestr编译器将string写入到一个.obj文件中,最终放置到可执行文件中。使用文件搜索工具可以从可执行文件中找到该string。
2)lib 连接器将一个string中指定的.lib文件写入到一个.obj文件中。
3)user 编译器将string写入到一个.obj文件中,但连接器忽略,就是说最终string不放置到可执行文件中。
7.#pragma defineonoption and #pragma undefineonoption
#pragma defineonoption name switch(es)#pragma undefineonoption name switch(es)
这两个pragma用于为若干个命令行开关建立一个别名(name)。除了部分负责输入的命令行开关(如-I、-L)外,大部分命令开关都可以在这两个指示符中使用。
#pragma defineonoption在别名中所有指定开关都已打开的情况下定义name。
#pragma undefineonoption在别名中所有指定开关都已打开的情况下不定义name。
例如,myfile.c文件包含下列代码:
#pragma defineonoption OPTIMIZING -O2
#ifdef OPTIMIZING
#pragma message We are optimizing with -O2
#else
#pragma message There are no optimizations turned on
#endif
bcc32 -c myfile.c,输出是There are no optimizations turned on
bcc32 -c -O2 myfile.c,输出是We are optimizing with -O2
下面是一个同时使用多个命令行开关的实例:
#define SWITCHES_ARE_OFF
#pragma undefineonoption SWITCHES_ARE_OFF -O2 -c -P -C
#ifdef SWITCHES_ARE_OFF
#pragma message At least one of the switches is not turned on
#else
#pragma message All switches are turned on
#endif
bcc32 -c myfile.c,输出是At least one of the switches is not turnedon
bcc32 -c -P -O2 -C,输出是All switches are turned on
8. #pragma exit and #pragma startup
#pragma startup function-name#pragma exit function-name
这两个pragma分别用于指定在main函数调用前调用和在_exit函数调用前调用的函数。函数定义格式如下:
void func(void);
priority参数数值范围为64-255,0值级别最高。级别越高,在main函数调用前越早调用,在-exit函数调用前越晚调用。缺省级别为100。0-63级别C库保留使用。
9.#pragma hdrfile
#pragma hdrfile “filename.CSM”hdrfile pragma用于指定预编译头文件的名称。前提是必须已启用预编译头文件功能。
10.#pragma hdrstop
hdrstop pragma用于终止若干个头文件的预编译,可有效减少预编译头文件占用的磁盘空间。凡在源文件中#pragmahdrstop指令之前被引用的头文件都将被预编译成预编译头文件。假如一个头文件同时被多个源文件引用,那么生成的预编译头文件同样可被多个源文件共享。因此,在工程中#pragmahdrstop指令之前包含通用头文件可获得更好的编译性能。
例如,一个新应用程序创建后,源文件”Unit1.cpp”都会包含类似内容:
#include // common header file
#pragma hdrstop // terminate list here
#include “Unit1.h” // specific header file
#pragma hdrstop指令只能在源文件中使用,头文件中使用没有任何效果。
11.#pragma inline
#pragma inline,该指令等同于”-B”命令行选项。.#pragma inline指令最好放在源文件的顶部,因为编译器每次遇到#pragmainline指令都会加上”-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__ ofC++Builder.
#else
#pragma message “sorry,you are not using C++Buildercompiler.”
#endif
15.#pragma obsolete
#pragma obsolete identifier凡是在程序代码中该指令后遇到identifier标识符,预编译器将第一时间给出一个警告信息。警告显示该标识符已作废。
16.#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指令和#pragmaoption push指令配对使用,用于恢复以前保存的命令行选项。例如:
#pragma option push
#include #pragma option pop
#include “ystuff.h”
下面的实例因push和pop指令未配对使用,将会产生一个空栈警告。
#pragma option push
#pragma option pop
#pragma option pop
通过#pragma warn -nop指令可以关闭这个警告。
有一点必须特别注意,必须保证每个文件中的#pragma option push和#pragma optionpop指令配对使用。如果在文件结尾和文件开始时的命令行选项堆栈内容不一致,将会显示一个警告:”以前的选项和警告没有恢复?”。通过#pragma nopushoptwarn.指令关闭这个警告。
17.#pragma pack
#pragma pack([{push | pop}[,]] [identifier[,]])
#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指令配对使用。
相关文章推荐
- 使用C++实现JNI接口需要注意的事项
- 关于指针的一些事情
- c++ primer 第五版 笔记前言
- share_ptr的几个注意点
- Lua中调用C++函数示例
- Lua教程(一):在C++中嵌入Lua脚本
- Lua教程(二):C++和Lua相互传递数据示例
- C++联合体转换成C#结构的实现方法
- C++高级程序员成长之路
- C++编写简单的打靶游戏
- C++ 自定义控件的移植问题
- C++变位词问题分析
- C/C++数据对齐详细解析
- C++基于栈实现铁轨问题
- C++中引用的使用总结
- 使用Lua来扩展C++程序的方法
- C++中调用Lua函数实例
- Lua和C++的通信流程代码实例
- C++的template模板中class与typename关键字的区别分析
- C与C++之间相互调用实例方法讲解