EXIT

Quit the current batch script, quit the current subroutine or quit the command processor (CMD.EXE) optionally setting an errorlevel code.

Syntax
      EXIT [/B] [exitCode]

Key
    /B        When used in a batch script, this option will exit 
              only the script (or subroutine) but not CMD.EXE

   exitCode   Sets the %ERRORLEVEL% to a numeric number.
              If quitting CMD.EXE, set the process exit code no.

You should never attempt to directly write to the %errorlevel% variable, (i.e. don’t try anything like SET errorlevel...) using the EXIT command provides a safe way to alter the value of the built-in errorlevel variable. Unlike goto:eof the Exit /b command allows you to set a specific errorlevel.

Exiting nested FOR loops, if EXIT /b can be used to exit a FOR loop that is nested within another FOR loop.
This will only work if the inner FOR loop is contained in a separate subroutine, EXIT /b terminates the subroutine.

Examples

Exit if a required file is missing
@Echo Off
If not exist MyimportantFile.txt Exit /b
Echo If we get this far the file was found

Set the errorlevel to 5
@Echo Off
call :setError
echo %errorlevel%
goto :eof

:setError
Exit /B 5

Using Exit /b to exit a nested FOR loop (so skipping the values X,Y andZ), but still continuing the main loop:

@Echo Off
Setlocal 
For %%A in (alpha beta gamma) DO (
   Echo Outer loop %%A
   call :inner 
)
goto :eof

:inner
For %%B in (U V W X Y Z) DO (
   if %%B==X ( exit /b 2 )
   echo    Inner loop    Outer=%%A Inner=%%B
)

EXIT is an internal command.

“Making music is not about a place you go. It’s about a place you get out of. I’m underwater most of the time, and music is like a tube to the surface that I can breathe through. It’s my air hole up to the world. If I didn’t have the music I’d be under water, dead” ~ Fiona Apple

Related:

VERIFY - Provides an alternative method of raising an errorlevel without exiting
TSKILL - End a running process
Powershell: Exit - Exit Powershell
Equivalent bash command (Linux): break - Exit from a loop


© Copyright SS64.com 1999-2014
Some rights reserved