-------------------------- 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: December 07, 2002 14:45 by
Content © 1997 Microsoft Corporation
All else © 2000-2005
Counter