语法
#pragma 语言符号字符串
语言符号字符串是给出特有编译器指令和参量的字符序列。数字符号(#)必须是包含编译指示行中的第一个非空白字符。空白字符可分开数字符号(#)和单词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 _disibledevent=>#pragma
message("Pentium processor build")#endifmessagestring参数可以是可扩展为一个字符串文字的宏,并且你可以以任何组合方式用字符串文字将这些宏合并起来。例如,下列语句显示了被编译的文件名以及该文件最后改动的日期和时间:
#pragma message("Compiling "__FILE__ )
#pragma message("Last modified on " __TIMESTAMP_ _)
once
#pragma once
该指令指定该编译指示驻留的文件将只在一次建立中被编译器包括(打开)一次。该编译指示的一种普通用法如下:
//header.h
#pragma once
//接着是你的C或C++代码
optimize
#pragma optimize( "[optimization-list]",{on|off} )
仅用于专业和企业版本的特征:代码优化只被Visual C++专业版和企业版支持。更多的信息参见Microsoft Visual C++联机编辑。
该指令指定在函数基中执行的优化。optimize编译指示必须出现在一个函数之外,并且在编译指示出现后定义的第一个函数处产生作用。on和off参量可以打开或关闭在Optimization-list中指定的选项。
optimization-list可以是0或在表2.2中给出参数。
表2.2 "优化"编译指示的参数
参量 优化类型
a 假定无别名
g 允许全局优化
p 提高浮点相容性
s或t 指定机器码的短或快序列
w 假定无交叉函数调用的别名
y 生成程序堆栈中的框架指针
这些是采用/O编译器选项的相同字母,例如:
#pragma optimize("atp", on)
用空字符串("")使用optimize编译指示是该指令的一种特殊形式,它可关闭所有的优化或恢复它们的原有(缺省的)设置。
#pragma optimize("",off)
...
#pragma optimize("", on)
pack
#pragma pack([n])
该指令指定结构和联合成员的紧凑对齐。而一个完整的转换单元的结构和联合
的紧凑对齐由/Zp选项设置。紧凑对齐用pace编译指示在数据说明层设置。该编译指示在其出现后的第一个结构或联合说明处生效。该编译指示对定义无效。当你使用#pragma pack(n)时,这里n为1、2、4、8或16。第一个结构成员之后的每个结构成员都被存储在更小的成员类型或n字节界限内。如果你使用无参量的#pragma pack,结构成员被紧凑为以/Zp指定的值。该缺省/Zp紧凑值为/Zp8。
编译器也支持以下增强型语法:
#pragma pack([[{push|pop},][标识符,]][n])
若不同的组件使用pack编译指示指定不同的紧凑对齐,这个语法允许你把程序组件组合为一个单独的转换单元。
带push参量的pack编译指示的每次出现将当前的紧凑对齐存储到一个内部编译器堆栈中。编译指示的参量表从左到右读取。如果你使用push,则当前紧凑值被存储起来;如果你给出一个n的值,该值将成为新的紧凑值。若你指定一个标识符,即你选定一个名称,则该标识符将和这个新的的紧凑值联系起来。
带一个pop参量的pack编译指示的每次出现都会检索内部编译器堆栈顶的值,并且使该值为新的紧凑对齐值。如果你使用pop参量且内部编译器堆栈是空的,则紧凑值为命令行给定的值,并且将产生一个警告信息。若你使用pop且指定一个n的值,该值将成为新的紧凑值。
若你使用pop且指定一个标识符, 所有存储在堆栈中的值将从栈中删除,直到找到一个匹配的标识符,这个与标识符相关的紧凑值也从栈中移出,并且这个仅在标识符入栈之前存在的紧凑值成为新的紧凑值。如果未找到匹配的标识符,将使用命令行设置的紧凑值,并且将产生一个一级警告。缺省紧凑对齐为8。
pack编译指示的新的增强功能让你编写头文件,确保在遇到该头文件的前后的紧凑值是一样的。
/* File name: include1.h*/
#pragma pack(push,enter_include1)
/* 你的包括文件代码... */
#pragma pack(pop, enter_include1)
/* include1.h结束 */
在上面的例子中,当前紧凑值与标识符enter_include1联系起来,并被压入头文件的项中。头文件末尾的pack编译指示删除所有可能出现在头文件中的干预紧凑值,并且删除与enter_include1相关的紧凑值。因此确保该头文件的前后的紧凑值是相同的。
这种新功能也允许你使用代码,例如头文件,它可以使用pack编译指示设置不同于在你的代码中设置的紧凑值的紧凑对齐:
#pragma pack(push,before_include1)
#include "include1.h"
#pragma pack( pop,before_include1)
在上面的例子中,对于出现在include.h中的紧凑值的任何变化,你的代码是受到保护的。
setlocale
#pragma setlocale("locale_string")
该指令在翻译宽字符常量和字符串文字时定义其场所(国家和语言)。由于用于转换多字节字符为宽位字符的算法可能由于场所或编译而不同,该执行文件在不同的场所运行也可能不同。这个编译指示提供了在编译时给出目标场所的方法。这保证了宽字符串以正确的格式进行存储。缺省的locale_ _string(场所字符串)是 “C”。“C”场所将每个该串中的字符映射为一个wchar_t(unsigned short)型的值。
warning
#pragma warning( warning-specifier:warning-number-list
[,warning-specifier:warning-number-list...])
#pragma warning(push[,n])#pragma warning(pop)
该指令允许选择性地改变编译器的警告消息。
warning-specifier可以是如下值之一:
警告指示符 含义
once 只显示一次指定的消息default将缺省的编译器行为应用于指定的消息
1,2,3,4 把给定的警告级应用于指定的警告消息
disable 不发出指定警告消息
error 作为错误报告指定的警告
warning-number-list(警告编号表)可以包含任何警告编号。在相同的编译指示指令中可指定多个选项如下:
#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
对于那些与代码生成有关,且大于4699的警告编号来说,这个warning编译指示仅当放在函数定义外时有效。如果警告编号大于4699或用在函数体内,则忽略该编译指示。下面的例子指出了禁止warning编译指示的正确位置,且随后恢复一个代码生成警告消息的产生。
int a;
#pragma warning( disable : 4705 )
void func()
{
a;
}
#pragma warning( default : 4705 )
warning编译指示也支持以下语法:
#pragma warning( push[,n])
#pragma warning( pop)
这里n代表警告级(1到4)。
编译指示warning(push)存储所有警告的当前警告状态。编译指示warning(push,n)存储所有警告的当前警告状态并设置全局警告级为n。
编译指示warning(pop)将上次压入栈的警告状态弹出,push和pop之间警告状态的任何变化都将被取消。考虑这个例子:
#pragma warning(push)
#pragma warning(disable : 4705)
#pragma warning(disable : 4706)
#pragma warning(disable : 4707)
// 某些代码
#pragma warning(pop)
在这段代码的未尾,pop恢复所有警告状态(包括4705、4706和4707)为它在代码起始处的警告状态。
当你编写头文件时,可以用push和pop以确保对于用户造成的警告状态的变化,不会影响头部的正确编译。通常在头部的起始处使用push,在末尾处使用pop。例如, 有一个在警告级4未彻底编译的头部。以下代码将警告级改为3,然后在头部的未尾恢复原来的警告级:
#pragma warning(push,3)
//说明/定义
#pragma warning(pop)
最新评论