Návratová hodnota cl.exe

  • Článek

Program cl.exe vrátí při úspěchu nulovou hodnotu (bez chyb), v opačném případě nenulovou hodnotu

Vrácená hodnota programu cl.exe může být užitečná při kompilaci ze skriptu, prostředí powershell, souboru .cmd nebo .bat. Pro případ, že se vyskytnou chyby nebo upozornění, doporučujeme výstup kompilátoru zachytit, abyste je mohli vyřešit.

Program cl.exe má příliš mnoho možných ukončovacích kódů, než aby zde byly všechny uvedeny. Kód chyby můžete vyhledat v souborech winerror.h nebo ntstatus.h, které jsou součástí sady Windows Software Development Kit v adresáři %ProgramFiles(x86)%\Windows Kits\version\Include\shared\. Kvůli vyhledávání se kódy chyb vrácené v desítkové soustavě musí převést do šestnáctkové soustavy. Například kód chyby -1073741620 se do šestnáctkové soustavy převede jako 0xC00000CC. Tato chyba se nachází v ntstatus.h, kde odpovídající zpráva je "Zadaný název sdílené složky nebyl nalezen na vzdáleném serveru.". Seznam kódů chyb systému Windows ke stažení naleznete v tématu [MS-ERREF] Kódy chyb systému Windows.

Ke zjištění významu chybových zpráv kompilátoru můžete použít také nástroj pro vyhledávání chyb v sadě Visual Studio. V příkazovém prostředí sady Visual Studio zadejte errlook.exe a spusťte nástroj. Nebo v integrovaném vývojovém prostředí sady Visual Studio na řádku nabídek zvolte Nástroje, Vyhledávání chyb. Zadáním chybové hodnoty najdete popisný text přidružený k této chybě. Další informace naleznete v tématu ERRLOOK Reference.

Poznámky

Následuje ukázkový soubor .bat, který používá vrácenou hodnotu programu cl.exe.

echo off
cl /W4 t.cpp
@if ERRORLEVEL == 0 (
   goto good
)

@if ERRORLEVEL != 0 (
   goto bad
)

:good
   echo "clean compile"
   echo %ERRORLEVEL%
   goto end

:bad
   echo "error or warning"
   echo %ERRORLEVEL%
   goto end

:end

Viz také

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