From Xojo Documentation

Revision as of 13:44, 10 February 2020 by PLefebvre (talk | contribs) (Sample Code)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
You are currently browsing the old Xojo documentation site. Please visit the new Xojo documentation site!

Language Keyword

Used in a Sub or Function statement to indicate that an arbitrary number of parameters of the specified data type can be passed.


ParamArray [parameterName As DataType]

Part Description
parameterName Name of parameter for which an indefinite number of arguments will be passed.
DataType Data type of the parameter. It can be any valid data type.


The ParamArray keyword enables you to pass an indefinite number of values of a specific data type without formally using an array. A call to a method or function that has been declared using ParamArray uses a comma-delimited list of values rather than an array. The ParamArray parameter is treated as an array in the method code.

ParamArray can only be used with the last parameter in a method.

Sample Code

The following function adds a list of numbers that are passed via ParamArray.

Function AddNumbers(ParamArray nums() As Integer) As Integer
// nums is treated as an array
Var i, total As Integer
For Each i In nums
total = total + i
Return Total
End Function

This function can now be called like this:

Var sum As Integer
sum = AddNumbers(1, 2, 3, 4, 5)
// sum = 15

Any number of integers can be passed to AddNumbers.

This approach is equivalent to the use of a manually populated array as shown below:

Function AddArray(nums() As Integer) As Integer
Var i, total As Integer
For Each i In nums
total = total + i
Return total
End Function

You can initialize the array and call the function in the following way:

Var myArray(-1) As Integer // create array without specifying size
Var n As Integer
myArray = Array(5, 10, 20) // assign 3 elements
n = AddArray(myArray)

See Also

Array function; Var, Function, Sub statements.