Difference between revisions of "MC-Basic:GOTO"

From SoftMC-Wiki
Jump to: navigation, search
m (1 revision)
m (adjusted layout)
Line 4: Line 4:
  
 
|SYNTAX=
 
|SYNTAX=
GOTO ''<program label><br>
+
GOTO ''<program label>''
<br>
 
  
<program lable>:''
+
''<program lable>'':
  
 
|AVAILABILITY=
 
|AVAILABILITY=
Line 13: Line 12:
  
 
|DESCRIPTION=
 
|DESCRIPTION=
The GOTO statement is used to perform an unconditional branch to another section of code. It references a label that must appear in the code. Labels are written as a name followed by a colon. Labels must appear on their own lines and they may be commented. You can only branch within a program, event, function, or subroutine. The GOTO statement and the label must be within the same program block. The GOTO statement can be compared to the conditional branching statements, IF..THEN and SELECT CASE.
+
The GOTO statement is used to perform an unconditional branch to another section of code.  
 +
It references a label that must appear in the code.  
 +
 
 +
Labels are written as a name followed by a colon.  
 +
Labels must appear on their own lines and they may be commented.  
 +
 
 +
You can only branch within a program, event, function, or subroutine.  
 +
The GOTO statement and the label must be within the same program block.  
 +
The GOTO statement can be compared to the conditional branching statements, IF..THEN and SELECT CASE.
  
 
|TYPE=
 
|TYPE=
Line 31: Line 38:
  
 
|LIMITATIONS=
 
|LIMITATIONS=
Write-Only. The label must appear on a line of its own. Labels may not be repeated within a task. A GOTO branch must reference a label within the same program block (PROGRAM…END PROGRAM, SUB…END SUB, <br>
+
* Write-Only.  
 
+
* The label must appear on a line of its own.  
FUNCTION…END FUNCTION, and ONEVENT…END ONEVENT).
+
* Labels may not be repeated within a task.  
 +
*A GOTO branch must reference a label within the same program block (PROGRAM…END PROGRAM, SUB…END SUB, FUNCTION…END FUNCTION, and ONEVENT…END ONEVENT).
  
 
|EXAMPLE=
 
|EXAMPLE=
Program<br>
+
<pre>
       ''<nowiki><code></nowiki>''<br>
+
Program
       GOTO Reference1<br>
+
       <nowiki><code></nowiki>
       ''<nowiki><code></nowiki>''<br>
+
       GOTO Reference1
 +
       <nowiki><code></nowiki>
  
Reference1:<br>
+
Reference1:
       ''<nowiki><code to be executed after GOTO></nowiki>''<br>
+
       <nowiki><code to be executed after GOTO></nowiki>
  
 
End Program
 
End Program
 +
</pre>
  
 
|SEE ALSO=
 
|SEE ALSO=

Revision as of 11:25, 19 January 2012

The GOTO statement is used to perform an unconditional branch to another section of code. It references a label that must appear in the code.

Labels are written as a name followed by a colon. Labels must appear on their own lines and they may be commented.

You can only branch within a program, event, function, or subroutine. The GOTO statement and the label must be within the same program block. The GOTO statement can be compared to the conditional branching statements, IF..THEN and SELECT CASE.

Syntax

GOTO <program label>

<program lable>:

Availability

All versions

Scope

Task

Limitations

  • Write-Only.
  • The label must appear on a line of its own.
  • Labels may not be repeated within a task.
  • A GOTO branch must reference a label within the same program block (PROGRAM…END PROGRAM, SUB…END SUB, FUNCTION…END FUNCTION, and ONEVENT…END ONEVENT).

Examples

Program
       <code>
       GOTO Reference1
       <code>

Reference1:
       <code to be executed after GOTO>

End Program

See Also