Editing mirc/commands/goto

{{mIRC menu}}
The '''/goto command''' allows you to jump to another part of the code. The goto command can only jump to a label within the same event, alias, or menu. The label must have been parsed by mIRC previously inside that event/alias/menu or the label is considered undefined. Calling a goto on an undefined label will result in a label not found error. Labels can be plain text strings or variables

'''Note:''' A goto cannot jump to a label that was skipped earlier in the code.

== Synopsis ==
 :<label>
 /goto <label>

== Switches ==
None

== Parameters ==
None

== Example ==
<syntaxhighlight lang="mIRC">; /is_even <1-9>
;
; Example: /is_even 2
;   2 is an even number.
;   2 is a prime number.
alias is_even {
  goto $1
  :0 | echo -a You typed zero. | return
  :4 | echo -a $1 is an even number.
  :1 | :9 | echo -a $1 is a perfect square. | return
  :2 | echo -a $1 is an even number.
  :3 | :5 | :7 | echo -a $1 is a prime number. | return
  :6 | :8 | echo -a $1 is an even number. | return
  :error
  echo -a Only single-digit numbers are allowed!
  reseterror
}</syntaxhighlight>

Note that skipped labels cannot be jumped into.

<syntaxhighlight lang="mIRC">; This example shows that a goto point not being parsed previously by mIRC cannot be reached.
;
alias testing_goto {
  if (1) echo -a 1
  elseif (1) { echo -a 2 | :test }
  goto test
}</syntaxhighlight>

The script above will produce the following error:

<pre>* /goto: 'test' not found (line 3, scriptfile.mrc)</pre>

== Compatibility ==
{{mIRC compatibility|4.5}}


== See also ==
* [[List of commands - mIRC|List of commands]]
* [[List of identifiers - mIRC|List of identifiers]]
* {{mIRC|/break}}
* {{mIRC|/continue}}
* {{mIRC|/if}}
* {{mIRC|/return}}
* {{mIRC|/while}}
{{mIRC command list}}

[[Category:mIRC commands|goto command - mIRC]]
Latest revision		Your text
Line 1:		Line 1:
−	{{~~mirc title\|/goto Command~~}}	+	{{mIRC menu}}
	The '''/goto command''' allows you to jump to another part of the code. The goto command can only jump to a label within the same event, alias, or menu. The label must have been parsed by mIRC previously inside that event/alias/menu or the label is considered undefined. Calling a goto on an undefined label will result in a label not found error. Labels can be plain text strings or variables		The '''/goto command''' allows you to jump to another part of the code. The goto command can only jump to a label within the same event, alias, or menu. The label must have been parsed by mIRC previously inside that event/alias/menu or the label is considered undefined. Calling a goto on an undefined label will result in a label not found error. Labels can be plain text strings or variables