if

在批处理程序中执行条件处理。

Syntax

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>]

Parameters

Parameter Description
not 指定仅当条件为 false 时,才应执行该命令。
错误级别 <number> 仅当 Cmd.exe 运行的上一个程序返回等于或大于 number 的退出代码时,才指定 true 条件。
<command> 指定满足上述条件时应执行的命令。
<string1>==<string2> 仅当 string1string2 相同时,才指定 true 条件。 这些值可以是文本字符串或批处理变量(例如,%1)。 无需将文本字符串括在引号中。
存在 <filename> 如果指定的文件名存在,则指定 true 条件。
<compareop> 指定三个字母比较运算符,包括:
  • EQU - 等于
  • NEQ - 不等于
  • LSS - 小于
  • LEQ - 小于或等于
  • GTR - 大于
  • GEQ - 大于或等于
/i 强制字符串比较忽略大小写。 您可以在 if 的形式上string1==string2使用 /i。 这些比较是通用的,因为如果 string1string2 都仅由数字组成,则字符串将转换为数字并执行数字比较。
cmdext版本 <number> 仅当与 Cmd.exe 命令扩展功能关联的内部版本号等于或大于指定的数字时,才指定一个 true 条件。 第一个版本为 1。 当向命令扩展添加重要增强功能时,它会增加一个增量。 禁用命令扩展时, cmdextversion 条件永远不会为 true(默认情况下,启用命令扩展)。
定义的 <variable> 如果定义了 变量 ,则指定 true 条件。
<expression> 指定命令行命令以及要在 else 子句中传递给命令的任何参数。
/? 在命令提示符下显示帮助。

Remarks

  • 如果 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 子句。

Examples

若要显示消息 找不到数据文件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.
)

Note

这些行可以组合成一行,如下所示:

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,请键入:

if %errorlevel% LEQ 1 goto okay