warning pragma
啟用編譯程式警告訊息行為的選擇性修改。
語法
#pragma warning(
warning-specifier:warning-number-list
[;warning-specifier:warning-number-list... ])
#pragma warning( push[,n ])
#pragma warning( pop )
言論
下列 warning-specifier 參數可供使用。
| warning-specifier | 意義 |
|---|---|
1、2、3、4 |
將指定的層級套用至指定的警告。 也開啟預設為關閉的指定警告。 |
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 ) 會彈出推送至堆疊的最後一個警告狀態。 您對 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。