if
在批次程式執行條件式處理。
語法
if [not] ERRORLEVEL <number> <command> [else <expression>]
if [not] <string1>==<string2> <command> [else <expression>]
if [not] exist <filename> <command> [else <expression>]
如果已啟用命令延伸模組，請使用下列語法：
if [/i] <string1> <compareop> <string2> <command> [else <expression>]
if cmdextversion <number> <command> [else <expression>]
if defined <variable> <command> [else <expression>]
參數
| 參數 | 描述 |
|---|---|
| not | 指定只有在條件為 false 時，才應執行命令。 |
errorlevel <number> |
只有在 Cmd.exe 執行的上一個程式傳回等於或大於 number 的結束代碼時，才會指定 true 條件。 |
<command> |
指定只有在符合上述條件時，才應執行命令。 |
<string1>==<string2> |
只有在 string1 和 string2 相同時，才會指定 true 條件。 這些值可以是常值字串或批次變數 (例如 %1)。 您不需要使用引號括住常值字串。 |
exist <filename> |
如果指定的檔案名稱存在，則會指定 true 條件。 |
<compareop> |
指定由三個字母組成的比較運算子，包括：
|
| /i | 強制規定字串比較會忽略大小寫。 您可以在 if 的 string1==string2 形式中使用 /i。 這些比較皆為一般比較，如果當中的 string1 和 string2 都是僅由數字組成，字串就會轉換為數字，並執行數值比較。 |
cmdextversion <number> |
只有在與 Cmd.exe 之命令延伸模組功能相關的內部版本數字等於或大於指定的數字時，才會指定 true 條件。 第一個版本為 1。 當命令延伸模組新增大量的增強功能時，就會逐一遞增。 當命令延伸模組停用時 (命令延伸模組會預設啟用)，cmdextversion 條件永遠不會為 true。 |
defined <variable> |
如果已定義 variable，則會指定 true 條件。 |
<expression> |
指定將命令列和任何參數傳遞至 else 子句中的命令。 |
| /? | 在命令提示字元顯示說明。 |
備註
如果 if 子句中指定的條件為 true，就會執行該條件後方的命令。如果條件為 false，則 if 子句會遭到忽略，而命令則會執行在 else 子句中指定的任何命令。
當程式停止運作時，就會傳回結束代碼。 若要使用結束代碼做為條件，請使用 errorlevel 參數。
如果使用 defined，就會將下列三個變數新增至環境：%errorlevel%、%cmdcmdline% 和 %cmdextversion%。
%errorlevel%：展開為 ERRORLEVEL 環境變數目前值的字串表示。 這個變數會假設目前還不存在名為 ERRORLEVEL 的現有環境變數。 若已存在，您將改為取得該 ERRORLEVEL 值。
%cmdcmdline%：展開為在 Cmd.exe 進行任何處理作業之前，傳遞至 Cmd.exe 的原始命令列。 這會假設目前還不存在名為 CMDCMDLINE 的現有環境變數。 若已存在，您將改為取得該 CMDCMDLINE 值。
%cmdextversion%：展開為 cmdextversion 目前值的字串表現。 這會假設目前還不存在名為 CMDEXTVERSION 的現有環境變數。 若已存在，您將改為取得該 CMDEXTVERSION 值。
您必須在相同命令列中的 if 後方使用 else 子句。
範例
若要顯示「Cannot find data file if the file Product.dat cannot be found」(如果找不到 Product.dat，便無法找到檔案資料) 訊息，請輸入：
if not exist product.dat echo Cannot find data file
若要將磁碟機 A 中的磁碟格式化，並在格式化過程發生錯誤時顯示錯誤訊息，請在批次檔案中輸入下列程式碼：
:begin
@echo off
format a: /s
if not errorlevel 1 goto end
echo An error occurred during formatting.
:end
echo End of batch program.
若要從目前的目錄中刪除檔案 Product.dat，或在找不到 Product.dat 時顯示訊息，請在批次檔案中輸入下列程式碼：
IF EXIST Product.dat (
del Product.dat
) ELSE (
echo The Product.dat file is missing.
)
注意
這些程式碼可合併在同一行，如下列所示：
IF EXIST Product.dat (del Product.dat) ELSE (echo The Product.dat file is missing.)
若要在執行批次檔案後回應 ERRORLEVEL 環境變數值，請在批次檔案中輸入下列程式碼：
goto answer%errorlevel%
:answer1
echo The program returned error level 1
goto end
:answer0
echo The program returned error level 0
goto end
:end
echo Done!
若要在 ERRORLEVEL 環境變數值小於或等於 1 時前往 okay 標籤，請輸入：
if %errorlevel% LEQ 1 goto okay