GoSub...Return Statement

Calls a subroutine that is indicated by a label inside a Sub or a Function. The statements following the label are executed until the next Return statement. Afterwards, the program continues with the statement that follows the GoSub statement.

Syntax:


GoSub label[:]

Parameters:

label: A line identifier indicating where to continue execution. The scope of a label in that of the routine it belongs to.

The GoSub statement calls a local subroutine indicated by a label from within a subroutine or a function. The name of the label must end with a colon (":").


  Sub/Function foo
      ' statements
      GoSub label
      ' statements
      Exit Sub/Function
  label:
      ' statements
      Return
  End Sub/Function

プログラムの実行時に、対応するGoSubの存在しないReturnステートメントに遭遇すると、Collabora Office Basicからエラーメッセージが返されます。こうした不適切なReturnステートメントの実行を避けるには、必要な箇所にExit SubないしExit Functionを記述して、該当するSubやFunctionを明示的に終了させる必要があります。

下記の例は、GoSub と Return を使用したサンプルコードです。ここではユーザーに 2 つの値を入力させていますが、これらの平方根の計算は、共通の処理セクションを 2 度呼び出すことで処理しています。

Example:


Sub ExampleGoSub
Dim iInputa As Single
Dim iInputb As Single
Dim iInputc As Single
    iInputa = Int(InputBox$ ("Enter the first number:","NumberInput"))
    iInputb = Int(InputBox$ ("Enter the second number:","NumberInput"))
    iInputc=iInputa
    GoSub SquareRoot
    Print "The square root of";iInputa;" is";iInputc
    iInputc=iInputb
    GoSub SquareRoot
    Print "The square root of";iInputb;" is";iInputc
    Exit Sub
SquareRoot:
    iInputc=sqr(iInputc)
    Return
End Sub

GoTo Statement

On...GoSub Statement; On...GoTo Statement