-------------------------- MS-DOS v6.22 Help: If ---------------------------
<Examples>                                                           <Index>
----------------------------------------------------------------------------
 
                                     IF
 
Performs conditional processing in batch programs. If the condition
specified by an IF command is true, MS-DOS carries out the command that
follows the condition. If the condition is false, MS-DOS ignores the
command. You can use this command only in batch programs.
 
Syntax
 
    IF [NOT] ERRORLEVEL number command
 
    IF [NOT] string1==string2 command
 
    IF [NOT] EXIST filename command
 
Parameters
 
NOT
    Specifies that MS-DOS should carry out the command only if the condition
    is false.
 
ERRORLEVEL number
    Specifies a true condition only if the previous program run by
    COMMAND.COM returned an exit code equal to or greater than number.
 
command
    Specifies the command that MS-DOS should carry out if the preceding
    condition is met.
 
string1==string2
    Specifies a true condition only if string1 and string2 are the same.
    These values can be literal strings or batch variables (%1, for
    example). Literal strings do not need quotation marks.
 
EXIST filename
    Specifies a true condition if filename exists.
 
                                      ***

<Syntax>
----------------------------------------------------------------------------
 
                                IF--Examples
 
The following example tests for the existence of a directory. The IF command
cannot be used to test directly for a directory, but the null (NUL) device
does exist in every directory on the hard drive. Therefore, you can test for
the null device to determine whether a directory exists on the hard drive.
 
    if exist c:\mydir\nul goto process
 
The following example displays the message "Can't find data file" if MS-DOS
cannot find the file PRODUCT.DAT:
 
    if not exist product.dat echo Can't find data file
 
When a program stops, it returns an exit code to MS-DOS. For example, a
value of 0 is typically used to indicate that a program was successfully
executed. The ERRORLEVEL parameter lets you use exit codes as conditions.
 
The following example displays an error message if an error occurs during
formatting of the disk in drive A. If no error occurs, the error message is
skipped.
 
    :begin
    echo off
    format a: /s
    if not errorlevel 1 goto end
    echo An error occurred during formatting.
    :end
    echo End of batch program.
 
For another example of how the ERRORLEVEL parameter is used, see the
<CHOICE> command.
 
                                      ***

----------------------------------------------------------------------------
<Top of page>
Last update: June 14, 2000 06:20 EST by -vjf-
Content © 1997 Microsoft Corporation
All else © 2000 Vernon J Frazee
Counter