<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="../../style.css">
<title>
Gambas Documentation - Labels
</title>
</head>
<table class="none" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr><td align="left">
<font size="-1">
<a href="../../help+en"><img class="flag" alt="Home" border="0" src="../../img/lang/en.png" align="center"></a>&nbsp;
<a href="../lang+en">Up</a>&nbsp;
<a href="kill+en">Previous</a>&nbsp;
<a href="last+en">Next</a>&nbsp;
</td></tr></table>
<div class="notab">
<h1>
Labels
</h1>
<div class="black"><font size="-2"><b>Syntax</b></font></div>
<pre class="syntax"><u>Identifier</u> <b>:</b></pre><p>

A label indicates a target for the <a href="goto+en">GOTO</a> instruction.
<p>
A label is local to a function or procedure.
<p>
<div class="warning"><table class="none" border="0"><tr><td width="40" valign="top"><img border="0" src="../../img/info.png" align="center"></td><td valign="top">
<p>
<a href="goto+en">GOTO</a> and labels can be used to leave a control structure.
<p>
<div class="gray"><font size="-2"><b>Example</b></font></div>
<pre class="example">FOR iY = 0 TO 5
  FOR iX = 0 TO 20 STEP 1
    PRINT &quot;Loop1 &quot;; iX
    IF iX = 3 THEN GOTO LOOP2
  NEXT
NEXT
loop2:</pre>
</td></tr></table></div>
<p>
<div class="warning"><table class="none" border="0"><tr><td width="40" valign="top"><img border="0" src="../../img/warning.png" align="center"></td><td valign="top">
<p>
But <a href="goto+en">GOTO</a> and labels cannot be used to enter a control structure.
This is forbidden, even if the variables are preset.
<p>
<div class="gray"><font size="-2"><b>Example</b></font></div>
<pre class="example">iX = 18
' GOTO LOOP3   ' forbidden
FOR iX = 20 TO -2 STEP -2
LOOP3:
  PRINT &quot;Loop2 &quot;; iX
NEXT</pre>
</td></tr></table></div>
<p>
<hr><b>See also</b><br>
<a href="goto+en">GOTO</a>&nbsp;

</div>
</body>
</html>

