Comando Goto

Comando Goto


Em um programa em lotes, direciona o Windows XP para uma linha identificada por um rótulo. Quando o rótulo é localizado, processa os comandos iniciados na linha seguinte.

Sintaxe
goto rótulo

Parâmetros
rótulo
Especifica a linha de um programa em lotes para a qual deseja ir.
/?
Exibe ajuda no prompt de comando.
Comentários
Trabalhando com extensões de comando
Se as extensões de comando estiverem ativadas (isto é, o padrão) e você usar o comando goto com um rótulo de destino :EOF, você transferirá o controle para o fim do arquivo de script em lotes atual e sairá dele sem definir um rótulo. Ao usar goto com o rótulo :EOF, você deve inserir um sinal de dois-pontos antes do rótulo. Por exemplo:

goto :EOF

Para obter uma descrição das extensões do comando call que tornam esse recurso útil, consulte cmd em Tópicos relacionados.

Usando valores de rótulo válidos
Você pode usar espaços no parâmetro rótulo, mas não pode incluir outros separadores (por exemplo, sinais de ponto-e-vírgula ou de igualdade). O comando goto utiliza somente os oito primeiros caracteres de um rótulo. Por exemplo, os rótulos a seguir são equivalentes e resolvidos como :hithere0:

:hithere0

:hithere01

:hithere02

Comparando rótulo com o rótulo do programa em lotes
O valor de rótulo especificado deve coincidir com um rótulo no programa em lotes. O rótulo contido no programa em lotes deve iniciar com dois-pontos (:). O Windows XP reconhece uma linha do programa em lotes iniciada com dois-pontos (:) como um rótulo e não a processa como um comando. Se uma linha começar com dois-pontos, todos os comandos dessa linha serão ignorados. Se o programa em lotes não tiver o rótulo que você especificar, esse programa será interrompido e a seguinte mensagem será exibida:

Rótulo não encontrado

Usando goto para operações condicionais
É possível usar goto com outros comandos para realizar operações condicionais. Para obter mais informações sobre o uso do comando goto para operações condicionais, consulte if em Tópicos relacionados.

Exemplos
O programa em lotes a seguir formata um disco na unidade A como disco do sistema. Se a operação tiver êxito, o comando goto direcionará o Windows XP para o rótulo :end:

echo off
format a: /s
if not errorlevel 1 goto end
echo Ocorreu um erro durante a formatação.
:end
echo Fim do programa em lotes.