启用对编译器警告消息行为的选择性修改。
语法
#pragma warning(
warning-specifier:warning-number-list,justification:string-literal[ ]
[;warning-specifier:warning-number-list... ])
#pragma warning( push,[ n ])
#pragma warning( pop )
言论
以下警告说明符参数可用。
| warning-specifier （警告说明符） | 意义 |
|---|---|
1、2、3、4 |
将给定级别应用于指定的警告。 例如： #pragma warning (3 : 5033) 关闭警告 5033（通常是 1 级警告），除非警告级别设置为 /w3 或更高。 还可用于打开默认情况下处于关闭状态的指定警告。 |
default |
将警告行为重置为其默认值。 此外，还打开默认关闭的指定警告。 警告将在其默认级别、记录级别生成。 有关详细信息，请参阅默认情况下关闭的编译器警告 |
disable |
不要发出指定的警告消息。 允许 optional justification 属性。 |
error |
将指定的警告报告为错误。 |
once |
仅显示一次指定的消息。 |
suppress |
在堆栈上推送 pragma 的当前状态，禁用下一行的指定警告，然后弹出警告堆栈，以便重置 pragma 状态。 允许 optional justification 属性。 |
下面的代码语句演示了 warning-number-list 参数可以包含多个警告号，并且可以在同一 warning-specifier 指令中指定多个 pragma 参数。
#pragma warning( disable : 4507 4034; once : 4385; error : 164 )
但是，当该字段存在时 justification ，只能指定一个警告编号。 以下代码语句说明了该 justification 字段的用法。
#pragma warning( disable : 4507, justification : "This warning is disabled" )
这些 justification 字段允许您解释禁用或禁止显示警告的原因。
justification该字段仅支持 disable 和 suppresswarning-specifier。 指定选项 /analyze:log:includesuppressed 后，此值将显示在 SARIF 输出中。 它的值是 UTF-8 编码的窄字符串文字。
此指令在功能上等效于以下代码：
// Disable warning messages 4507 and 4034.
#pragma warning(disable : 4507 4034)
// 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 compiling Test()
}
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 ) 弹出推送到堆栈的最后一个警告状态。 取消对 push 和 pop 之间的警告状态所做的任何更改。 请考虑以下示例：
#pragma warning( push )
#pragma warning( disable : 4705 )
#pragma warning( disable : 4706 )
#pragma warning( disable : 4707 )
// Some code
#pragma warning( pop )
在此代码结束时，pop 将每个警告的状态（包括 4705、4706 和 4707）还原到代码开头的状态。
编写头文件时，可以使用 push 和 pop 来保证用户所做的警告状态更改不会阻止标头正确编译。 在标头的开头使用 push，并在末尾使用 pop。 例如，你可能具有在警告级别 4 上无法完全编译的标头。 以下代码将警告级别更改为 3，然后在标头末尾还原原始警告级别。
#pragma warning( push, 3 )
// Declarations/definitions
#pragma warning( pop )
有关帮助取消警告的编译器选项的详细信息，请参阅 /FI 和 /w。