Goto

Em um programa em lotes, direciona o Microsoft Windows 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 Microsoft Windows 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á mostrada:

  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 Microsoft Windows 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.XOX