Partilhar via

se

Executa processamento condicional em programas em lote.

Sintaxe

if [not] ERRORLEVEL <number> <command> [else <expression>]
if [not] <string1>==<string2> <command> [else <expression>]
if [not] exist <filename> <command> [else <expression>]

Se as extensões de comando estiverem habilitadas, use a seguinte sintaxe:

if [/i] <string1> <compareop> <string2> <command> [else <expression>]
if cmdextversion <number> <command> [else <expression>]
if defined <variable> <command> [else <expression>]

Parâmetros

Parâmetro Descrição
não Especifica que o comando deve ser executado somente se a condição for false.
Nível de erro <number> Especifica uma condição verdadeira somente se o programa anterior executado por Cmd.exe retornou um código de saída igual ou maior que número.
<command> Especifica o comando que deve ser executado se a condição anterior for atendida.
<string1>==<string2> Especifica uma condição verdadeira somente se string1 e string2 forem as mesmas. Esses valores podem ser cadeias de caracteres literais ou variáveis de lote (por exemplo, %1). Não é necessário colocar cadeias de caracteres literais entre aspas.
existem <filename> Especifica uma condição verdadeira se o nome de arquivo especificado existir.
<compareop> Especifica um operador de comparação de três letras, incluindo:
  • EQU - Igual a
  • NEQ - Não igual a
  • LSS - Menos de
  • LEQ - Inferior ou igual a
  • GTR - Maior que
  • GEQ - Maior ou igual a
/eu Força as comparações de cadeia de caracteres a ignorar maiúsculas e minúsculas. Você pode usar /i na forma string1==string2 de se. Essas comparações são genéricas, na medida em que, se string1 e string2 forem compostas apenas por dígitos numéricos, as cadeias de caracteres serão convertidas em números e uma comparação numérica será realizada.
cmdextversion <number> Especifica uma condição verdadeira somente se o número de versão interno associado ao recurso de extensões de comando do Cmd.exe for igual ou maior que o número especificado. A primeira versão é 1. Ele aumenta em incrementos de um quando aprimoramentos significativos são adicionados às extensões de comando. O cmdextversion condicional nunca é verdadeiro quando as extensões de comando são desabilitadas (por padrão, as extensões de comando são habilitadas).
definido <variable> Especifica uma condição verdadeira se variável estiver definida.
<expression> Especifica um comando de linha de comando e quaisquer parâmetros a serem passados para o comando em uma cláusula else.
/? Exibe a ajuda no prompt de comando.

Observações

  • Se a condição especificada em um se cláusula for verdadeira, o comando que segue a condição será executado. Se a condição for false, o comando no se cláusula for ignorada e o comando executará qualquer comando especificado na cláusula else.

  • Quando um programa para, ele retorna um código de saída. Para usar códigos de saída como condições, use o parâmetro errorlevel.

  • Se você usar definido, as três variáveis a seguir serão adicionadas ao ambiente: %errorlevel%, %cmdcmdline%e %cmdextversion%.

    • %errorlevel%: Expande para uma representação de cadeia de caracteres do valor atual da variável de ambiente ERRORLEVEL. Essa variável pressupõe que ainda não existe uma variável de ambiente com o nome ERRORLEVEL. Se houver, você obterá esse valor ERRORLEVEL.

    • %cmdcmdline%: Expande para a linha de comando original que foi passada para Cmd.exe antes de qualquer processamento por Cmd.exe. Isso pressupõe que ainda não exista uma variável de ambiente com o nome CMDCMDLINE. Se houver, você obterá esse valor CMDCMDLINE.

    • %cmdextversion%: Expande para a representação de cadeia de caracteres do valor atual de cmdextversion. Isso pressupõe que ainda não exista uma variável de ambiente com o nome CMDEXTVERSION. Se houver, você obterá esse valor CMDEXTVERSION em vez disso.

  • Você deve usar a cláusula else na mesma linha do comando após o se.

Exemplos

Para exibir a mensagem Não é possível localizar o arquivo de dados se o arquivo Product.dat não puder ser encontrado, digite:

if not exist product.dat echo Cannot find data file

Para formatar um disco na unidade A e exibir uma mensagem de erro se ocorrer um erro durante o processo de formatação, digite as seguintes linhas em um arquivo em lotes:

:begin
@echo off
format a: /s
if not errorlevel 1 goto end
echo An error occurred during formatting.
:end
echo End of batch program.

Para excluir o arquivo Product.dat do diretório atual ou exibir uma mensagem se Product.dat não for encontrado, digite as seguintes linhas em um arquivo em lotes:

IF EXIST Product.dat (
del Product.dat
) ELSE (
echo The Product.dat file is missing.
)

Observação

Essas linhas podem ser combinadas em uma única linha da seguinte maneira:

IF EXIST Product.dat (del Product.dat) ELSE (echo The Product.dat file is missing.)

Para ecoar o valor da variável de ambiente ERRORLEVEL depois de executar um arquivo em lotes, digite as seguintes linhas no arquivo em lotes:

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!

Para ir para o rótulo ok se o valor da variável de ambiente ERRORLEVEL for menor ou igual a 1, digite:

if %errorlevel% LEQ 1 goto okay