/w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (úroveň upozornění)

  • Článek

Určuje, jak kompilátor generuje upozornění pro danou kompilaci.

Syntaxe

/W
/W0
/W1
/W2
/W3
/W4
/Zdi
/Wv[:version]
/WX
/w1– upozornění
/w2– upozornění
/w3– upozornění
/w4– upozornění
/wdwarning
/wewarning
/wowarning

Poznámky

Možnosti upozornění určují, která upozornění kompilátoru se mají zobrazit, a chování upozornění pro celou kompilaci.

Možnosti upozornění a související argumenty jsou popsány v následujících tabulkách:

Možnost Popis
/W Potlačí všechna upozornění kompilátoru.
/W0

/W1

/W2

/W3

/W4		 Určuje úroveň upozornění, která má kompilátor vygenerovat. Platné úrovně upozornění jsou v rozsahu od 0 do 4:
/W0 potlačí všechna upozornění. Je ekvivalentem /w.
/W1 zobrazuje upozornění úrovně 1 (závažné). /W1 je výchozí nastavení v kompilátoru příkazového řádku.
/W2 zobrazuje upozornění úrovně 1 a 2 (významné).
/W3 zobrazí upozornění úrovně 1, úrovně 2 a úrovně 3 (produkční kvalita). /W3 je výchozí nastavení v integrovaném vývojovém prostředí (IDE).
/W4 zobrazuje upozornění úrovně 1, úrovně 2 a úrovně 3 a všechna upozornění úrovně 4 (informační), která nejsou ve výchozím nastavení vypnutá. Tuto možnost doporučujeme použít k poskytování upozornění podobných lintům. Pro nový projekt může být nejlepší použít /W4 ve všech kompilacích. Tato možnost pomáhá zajistit co nejmenší možné chyby kódu, které je obtížné najít.
/Zdi Zobrazí všechna upozornění zobrazená pomocí /W4 a všechna ostatní upozornění, která /W4 neobsahuje – například upozornění, která jsou ve výchozím nastavení vypnutá. Další informace najdete v tématu Upozornění kompilátoru, která jsou ve výchozím nastavení vypnutá.
/Wv[:version] Zobrazí pouze upozornění představená ve verzi kompilátoru verzí a starších verzích. Tuto možnost můžete použít k potlačení nových upozornění v kódu při migraci na novější verzi kompilátoru. Umožňuje udržovat stávající proces sestavení během jejich opravy. Volitelná verze parametru má tvar nn[.mm[.bbbbb]], kde nn je číslo hlavní verze, mm je volitelné číslo podverze a bbbbb je volitelné číslo sestavení kompilátoru. Například pomocí /Wv:17 můžete zobrazit pouze upozornění představená v sadě Visual Studio 2012 (hlavní verze 17) nebo starší. To znamená, že zobrazí upozornění z jakékoli verze kompilátoru, která má číslo hlavní verze 17 nebo méně. Potlačí upozornění představená v sadě Visual Studio 2013 (hlavní verze 18) a novější. Ve výchozím nastavení /Wv používá aktuální číslo verze kompilátoru a nejsou potlačována žádná upozornění. Informace o tom, která upozornění jsou potlačena verzí kompilátoru, naleznete v tématu Upozornění kompilátoru podle verze kompilátoru.
/WX Zpracovává všechna upozornění kompilátoru jako chyby. Pro nový projekt může být nejlepší použít /WX ve všech kompilacích; řešení všech upozornění zajišťuje co nejmenší možné chyby kódu.

Linker má také možnost /WX . Další informace najdete v tématu /WX (zpracování upozornění linkeru jako chyb).

Následující možnosti se vzájemně vylučují. Poslední možnost zadaná z této skupiny je ta, která se použije:

Možnost Popis
/w1nnnn

/w2nnnn

/w3nnnn

/w4nnnn		 Nastaví úroveň upozornění pro číslo upozornění určené nnnn. Tyto možnosti umožňují změnit chování kompilátoru pro toto upozornění, když je nastavena konkrétní úroveň upozornění. Tyto možnosti můžete použít v kombinaci s dalšími možnostmi upozornění k vynucení vlastních standardů kódování pro upozornění, nikoli výchozích hodnot poskytovaných sadou Visual Studio.

Například /w34326 způsobí, že se místo úrovně 1 vygeneruje upozornění C4326 jako upozornění úrovně 3. Pokud kompilujete pomocí možnosti /w34326 i možnosti /W2 , upozornění C4326 se nevygeneruje.
/wdnnnn Potlačí upozornění kompilátoru určené nnnn.

Například /wd4326 potlačí upozornění kompilátoru C4326.
/wennnn Zachází s upozorněním kompilátoru, který je určen nnnn jako chyba.

Například /we4326 způsobí, že kompilátor považuje číslo C4326 za chybu.
/wonnnn Hlásí upozornění kompilátoru určené nnnn pouze jednou.

Například /wo4326 způsobí, že se upozornění C4326 hlásí pouze jednou, když kompilátor poprvé narazí.

Pokud při vytváření předkompilované hlavičky použijete jakékoli možnosti upozornění, zachová tato nastavení. Použití předkompilované hlavičky znovu vloží stejné možnosti upozornění. Pokud chcete přepsat možnosti upozornění na předkompilované záhlaví, nastavte další možnost upozornění na příkazovém řádku.

Pomocí direktivy upozornění #pragma můžete řídit úroveň upozornění, která se hlásí v době kompilace v konkrétních zdrojových souborech.

Direktivy pragma upozornění ve zdrojovém kódu nejsou ovlivněny možností /w .

Dokumentace k chybám sestavení popisuje upozornění a úrovně upozornění a označuje, proč se určité příkazy nemusí kompilovat podle plánu.

Nastavení možností kompilátoru ve vývojovém prostředí sady Visual Studio

  1. Otevřete dialogové okno Stránky vlastností projektu. Podrobnosti najdete v tématu Nastavení kompilátoru C++ a vlastností sestavení v sadě Visual Studio.

  2. Pokud chcete nastavit možnosti /W0, /W1, /W2, /W3, /W4, /Wall, /Wv, /WX nebo /WX- vyberte Vlastnosti>konfigurace C/C++>Obecné.

    • Chcete-li nastavit možnosti /W0, /W1, /W2, /W3, /W4 nebo /Wall , upravte vlastnost Úroveň upozornění.

    • Chcete-li nastavit /WX nebo /WX- možnosti, upravte Vlastnost Treat Warnings as Errors .

    • Chcete-li nastavit verzi pro možnost /Wv , zadejte číslo verze kompilátoru ve vlastnosti Warning Version .

  3. Pokud chcete nastavit možnosti /wd nebo /we, vyberte stránku vlastností>konfigurace C/C++>Advanced.

    • Chcete-li nastavit možnost /wd , vyberte ovládací prvek Zakázat konkrétní upozornění vlastnost rozevírací seznam a pak zvolte Upravit. Do textového pole v dialogovém okně Zakázat konkrétní upozornění zadejte číslo upozornění. Pokud chcete zadat více než jedno upozornění, oddělte hodnoty středníkem (;). Pokud chcete například zakázat C4001 i C4010, zadejte 4001; 4010. Kliknutím na OK uložte změny a vraťte se do dialogového okna Stránky vlastností.

    • Chcete-li nastavit možnost /we , vyberte ovládací prvek Pro zpracování konkrétních upozornění jako chyby rozevírací seznam a pak zvolte Upravit. Do textového pole v dialogovém okně Považovat konkrétní upozornění jako chyby zadejte číslo upozornění. Pokud chcete zadat více než jedno upozornění, oddělte hodnoty středníkem (;). Pokud chcete například zacházet s chybami C4001 i C4010, zadejte 4001; 4010. Kliknutím na OK uložte změny a vraťte se do dialogového okna Stránky vlastností.

  4. Pokud chcete nastavit možnost /wo, vyberte stránku vlastností příkazového řádku C/C++>Vlastnosti>konfigurace. Do pole Další možnosti zadejte možnost kompilátoru.

  5. Kliknutím na OK uložte provedené změny.

Programové nastavení možnosti kompilátoru

Viz také

Možnosti kompilátoru MSVC
Syntaxe příkazového řádku kompilátoru MSVC