goto
Direciona cmd.exe para uma linha rotulada em um programa em lote. Em um programa em lotes, esse comando direciona o processamento de comando para uma linha identificada por um rótulo. Quando o rótulo é encontrado, o processamento continua começando com os comandos que começam na próxima linha.
Sintaxe
goto <label>
Parâmetros
| Parâmetro | Descrição |
|---|---|
<label> |
Especifica uma cadeia de caracteres de texto que é usada como um rótulo no programa em lote. |
| /? | Exibe a ajuda no prompt de comando. |
Comentários
Se as extensões de comando estiverem habilitadas (o padrão) e você usar o comando goto com um rótulo de destino de :EOF, você transferirá o controle para o final do arquivo de script em lote atual e sairá do arquivo de script em lote sem definir um rótulo. Ao usar esse comando com o rótulo :EOF, você deve inserir dois-pontos antes do rótulo. Por exemplo:
goto:EOF.Você pode usar espaços no parâmetro label, mas não pode incluir outros separadores (por exemplo, sinais de ponto e vírgula (;) ou de igual (=)).
O valor do rótulo que você especificar deve corresponder a um rótulo no programa em lote. O rótulo dentro do programa em lotes deve começar com dois-pontos (:). Se uma linha começar com dois-pontos, ela será tratada como um rótulo e todos os comandos nessa linha serão ignorados. Se o programa em lotes não tiver o rótulo especificado no parâmetro label, o programa em lote será interrompido e exibirá a seguinte mensagem:
Label not found.Você pode usar goto com outros comandos para executar operações condicionais. Para obter mais informações sobre como usar goto em operações condicionais, consulte o comando if.
Exemplos
O programa em lote a seguir formata um disco na unidade A como um disco do sistema. Se a operação for bem-sucedida, o comando goto direcionará o processamento para o rótulo :end:
echo off
format a: /s
if not errorlevel 1 goto end
echo An error occurred during formatting.
:end
echo End of batch program.