GOTO/GOTO DWORD statements

Purpose

Transfer program execution to the statement identified by a label or line number.

Syntax

GOTO {label | linenumber}

GOTO DWORD dwpointer

Remarks

GOTO causes program flow to jump unconditionally to the code identified by label or linenumber.  The label or linenumber must be local to the Sub, Function, Method, or Property where the GOTO statement is located.  GOTO differs from GOSUB and other similar control statements, in that after execution of a GOTO, the program retains no memory of where it was before it executed the jump.

Labels and line numbers are private. You cannot GOTO a label outside of the current procedure.

DWORD

GOTO DWORD causes execution to jump unconditionally to address stored in dwpointer.  dwpointer must be a  Double word, Long integer, or Pointer variable that contains the address of a label which is local to the procedure where the GOTO DWORD statement is located.

See also

CALL, CALL DWORD, DO/LOOP, EXIT, FOR/NEXT, FUNCTION, GOSUB, IF block, METHOD, PROPERTY, RETURN, SELECT, SUB, WHILE/WEND

Example

FUNCTION test() AS LONG

  RESET X

Start:           ' define a label

  INCR X         ' increment X

  IF X < 10 THEN DoBeep

  EXIT FUNCTION

  .[statements]

DoBeep:

  BEEP

  GOTO Start     ' jump back to Start

END FUNCTION

One method of obtaining the same results without use of GOTO is:

FUNCTION test() AS LONG

  FOR X = 1 TO 9

    GOSUB DoBeep

  NEXT X

  EXIT FUNCTION

  [statements]

DoBeep:

  BEEP

  RETURN

END FUNCTION