warning pragma

启用对编译器警告消息行为的选择性修改。

语法

#pragma warning(
warning-specifier : warning-number-list
 [;warning-specifier:warning-number-list ... ])
#pragma warning( push [ ,n ] )
#pragma warning( pop )

言论

以下警告说明符参数可用。

warning-specifier 意义
1234 将给定级别应用于指定的警告。 此外,还打开默认关闭的指定警告。
default 将警告行为重置为其默认值。 此外,还打开默认关闭的指定警告。 警告将在其默认级别、记录级别生成。

有关详细信息,请参阅默认情况下关闭的编译器警告
disable 不要发出指定的警告消息。
error 将指定的警告报告为错误。
once 仅显示一次指定的消息。
suppress 在堆栈上推送 pragma 的当前状态,禁用下一行的指定警告,然后弹出警告堆栈,以便重置 pragma 状态。

下面的代码语句演示了 warning-number-list 参数可以包含多个警告号,并且可以在同一 pragma 指令中指定多个 warning-specifier 参数。

#pragma warning( disable : 4507 34; once : 4385; error : 164 )

此指令在功能上等效于以下代码:

// Disable warning messages 4507 and 4034.
#pragma warning( disable : 4507 34 )

// Issue warning C4385 only once.
#pragma warning( once : 4385 )

// Report warning C4164 as an error.
#pragma warning( error : 164 )

编译器将 4000 添加到介于 0 到 999 之间的任何警告编号。

范围 4700-4999 中的警告编号与代码生成相关联。 对于这些警告,当编译器到达函数定义时,警告的状态将仍然对函数的其余部分有效。 使用函数中的 warningpragma 更改大于 4699 的警告号的状态仅在函数末尾后生效。 以下示例演示了正确放置 warningpragma 以禁用代码生成警告消息,然后还原它。

// pragma_warning.cpp
// compile with: /W1
#pragma warning(disable:4700)
void Test() {
   int x;
   int y = x;   // no C4700 here
   #pragma warning(default:4700)   // C4700 enabled after Test ends
}

int main() {
   int x;
   int y = x;   // C4700
}

请注意,在整个函数正文中,warningpragma 的最后一个设置将对整个函数生效。

推送和弹出

warning pragma 还支持以下语法,其中可选的 n 参数表示警告级别(1 到 4)。

#pragma warning( push [ , n ] )

#pragma warning( pop )

pragma warning( push ) 存储每个警告的当前警告状态。 pragma warning( push, n ) 存储每个警告的当前状态,并将全局警告级别设置为 n

pragma warning( pop ) 弹出推送到堆栈的最后一个警告状态。 取消对 pushpop 之间的警告状态所做的任何更改。 请考虑以下示例:

#pragma warning( push )
#pragma warning( disable : 4705 )
#pragma warning( disable : 4706 )
#pragma warning( disable : 4707 )
// Some code
#pragma warning( pop )

在此代码结束时,pop 将每个警告的状态(包括 4705、4706 和 4707)还原到代码开头的状态。

编写头文件时,可以使用 pushpop 来保证用户所做的警告状态更改不会阻止标头正确编译。 在标头的开头使用 push,并在末尾使用 pop。 例如,你可能具有在警告级别 4 上无法完全编译的标头。 以下代码将警告级别更改为 3,然后在标头末尾还原原始警告级别。

#pragma warning( push, 3 )
// Declarations/definitions
#pragma warning( pop )

有关帮助取消警告的编译器选项的详细信息,请参阅 /FI/w

另请参阅

Pragma 指令和 __pragma_Pragma 关键字