Call Statement

 

Transfers control to a Sub or Function procedure.

Syntax

[Call] name [argumentlist]

Arguments

  • Call
    Optional keyword. If specified, you must enclose argumentlist in parentheses. For example:

    Call MyProc(0)

  • name
    Required. Name of the procedure to call.

  • argumentlist
    Optional. Comma-delimited list of variables, arrays, or expressions to pass to the procedure.

Remarks

You are not required to use the Call keyword when calling a procedure. However, if you use the Call keyword to call a procedure that requires arguments, argumentlist must be enclosed in parentheses. If you use either Call syntax to call any intrinsic or user-defined function, the function's return value is discarded.

The following example illustrates the use of the Call statement.

Dim retValue

' Call the function with and without the "Call" keyword.
Call ShowSum(3, 4)
ShowSum 5, 6

' Omitting the "Call" keyword allows access
' to the function's return value.
retValue = ShowSum(7, 8)
MsgBox "The function returned:  " & retValue

Function ShowSum(value1, value2)
    Dim sum

    ' Determine and display the sum.
    sum = value1 + value2
    MsgBox "The sum is:  " & sum

    ' Set the function's return value.
    ShowSum = sum
End Function

Requirements

Version 1

Change History

Date

History

Reason

April 2009

Modified syntax information in "Remarks" section.

Content bug fix.

April 2009

Modified example.

Customer feedback.