IF: Executa processamento condicional em programas batch.

... "IF" Trecho da Ajuda do Microsoft Windows
... Os exemplos para o comando "IF"
... Informações importantes, dicas para o comando "IF"

"IF" Trecho da Ajuda do Microsoft Windows

Microsoft Windows [Version 10.0.19045.3693]
(c) Copyright 1985-2023 Microsoft Corp.

C:\\Windows>

Efectua o processamento condicional em programas batch.

IF [NOT] número ERRORLEVEL comando
IF [NOT] cadeia1==cadeia2 comando
IF [NOT] EXIST nomefich comando

NOT Especifica que o Windows deve executar o comando
apenas se a condição for falsa.

número ERRORLEVEL Especifica uma condição verdadeira se a última execução
do programa devolveu um código de saída igual ou maior
que o número especificado.

cadeia1==cadeia2 Especifica uma condição verdadeira se o texto das
cadeias especificadas for igual.

EXIST nomefich Especifica uma condição verdadeira se existir
o nome de ficheiro especificado.

comando Especifica o comando a executar se a condição for
verificada. O comando pode ser seguido pelo comando
ELSE que executará o comando depois da palavra chave
ELSE se a condição especificada for FALSE

A classe ELSE tem de ocorrer na mesma linha do comando a seguir ao IF. Por
exemplo:

IF EXIST nomefich. (
del nomefich.
) ELSE (
echo nomefich. Em falta.
)

O seguinte NÃO funcionaria porque o comando del necessita de terminar
com uma linha nova:

IF EXIST nomefich. del nomefich. ELSE echo nomefich. em falta

Nem o seguinte funcionaria, uma vez que o comando ELSE tem de estar
na mesma linha que o fim do comando IF:

IF EXIST nomefich. del nomefich.
ELSE echo nomefich. em falta

O seguinte funcionaria se colocasse tudo na mesma linha:

IF EXIST nomefich. (del nomefich.) ELSE echo nomefich. em falta

Se as extensões de comandos estiverem activadas, o IF é alterado do seguinte
modo:

IF [/I] cadeia1 op-comparação cadeia2 comando
IF CMDEXTVERSION número comando
IF DEFINED variável comando

onde op-comparação pode ser um de:

EQU - igual a
NEQ - não igual a
LSS - menor que
LEQ - menor ou igual a
GTR - maior que
GEQ - maior ou igual a

e o parâmetro /I, se for especificado, indica a comparação entre cadeias
sem sensibilidade a maiúsculas e minúsculas. O parâmetro /I também pode ser
utilizado na forma cadeia1==cadeia2 de IF. Estas comparações são genéricas,
pelo que se a cadeia1 e a cadeia2 forem constituídas apenas por dígitos
numéricos, as cadeias são convertidas em números e é efectuada uma comparação
numérica.

O CMDEXTVERSION condicional funciona da mesma forma que o ERRORLEVEL, excepto
na comparação que é feita contra um número de versão interna associado às
extensões de comandos. A primeira versão é 1. Será incrementada de uma 
unidade
sempre que forem adicionadas melhorias significativas às extensões de 
comandos.
O CMDEXTVERSION condicional nunca é verdadeiro quando as extensões de 
comandos
estão desactivadas.

O DEFINED condicional funciona da mesma forma que o EXISTS mas toma um nome
de uma variável de ambiente e devolve verdadeiro se a variável de ambiente
estiver definida.

O %ERRORLEVEL% expandirá para uma representação em cadeia do
valor actual do ERRORLEVEL, desde que não exista já uma variável
com o nome ERRORLEVEL, em cujo caso obterá o seu valor. Depois de
executar um programa, o que se segue ilustra a utilização do ERRORLEVEL:

goto resposta%ERRORLEVEL%
:resposta0
echo O programa devolveu o código 0
:resposta1
echo O programa devolveu o código 1

Também pode, através das comparações numéricas já indicadas:

IF %ERRORLEVEL% LEQ 1 goto ok

%CMDCMDLINE% expandirá para a linha de comandos original passada para
o CMD.EXE antes de qualquer processamento por parte do CMD.EXE, desde que
não exista já uma variável de ambiente com o nome CMDCMDLINE, em cujo caso
obterá o seu valor.

O %CMDEXTVERSION% expandirá para uma representação em cadeia do valor actual
do CMDEXTVERSION, desde que não exista já uma variável de ambiente com o nome
CMDEXTVERSION, em cujo caso obterá o seu valor.

Os exemplos para o comando "IF"

@ECHO OFF
SET Variable1=10
SET Variable2=10

IF %Variable1% EQU %Variable2% (
    ECHO As variáveis ​​são as mesmas.
) ELSE (
    ECHO As variáveis ​​não são iguais.
)

@ECHO OFF
IF EXIST C:\Exemplo.txt (
    ECHO o arquivo existe.
) ELSE (
    ECHO O arquivo não existe.
)

@ECHO OFF
SET /P entrada_do_usuário=por favor insira um valor: 

IF "%entrada_do_usuário%"=="" (
    ECHO Você não inseriu um valor.
) ELSE (
    ECHO Eles têm "%entrada_do_usuário%" entrou.
)

@ECHO OFF
SET arquivo=C:\Exemplo.txt
SET Tamanho_mínimo=1024

FOR %%A IN (%arquivo%) DO SET tamanho do arquivo=%%~zA

IF %tamanho do arquivo% GEQ %Tamanho_mínimo% (
    ECHO O arquivo atende ao tamanho mínimo.
) ELSE (
    ECHO O arquivo é muito pequeno.
)

@ECHO OFF
VER | FIND "Windows 10" > NUL

IF %ERRORLEVEL% EQU 0 (
    ECHO você usa Windows 10.
) ELSE (
    ECHO Você está usando um sistema operacional diferente.
)

Informações importantes, dicas para o comando "IF"

IF Doença (
    Echo A condição é verdadeira.
) ELSE (
    Echo A condição é falsa.
)

DIR C:\Diretório_inexistente
IF %ERRORLEVEL% NEQ 0 (
    Echo Erro ao executar DIR-comando.
)

IF Exist arquivo.txt IF %Variable% EQU Valor (
    Echo Ambas as condições são verdadeiras.
)