User Guide

Function.apply() 291
Function class
Availability
Flash Player 6.
Description
Both user-defined and built-in functions in ActionScript are represented by Function objects,
which are instances of the Function class.
Method summary for the Function class
Function.apply()
Availability
Flash Player 6.
Usage
myFunction.apply(thisObject:Object, argumentsArray:Array)
Parameters
thisObject
The object to which myFunction is applied.
argumentsArray An array whose elements are passed to myFunction as parameters.
Returns
Any value that the called function specifies.
Description
Method; specifies the value of this to be used within any function that ActionScript calls. This
method also specifies the parameters to be passed to any called function. Because
apply() is a
method of the Function class, it is also a method of every Function object in ActionScript.
The parameters are specified as an Array object, unlike
Function.call(), which specifies
parameters as a comma-delimited list. This is often useful when the number of parameters to be
passed is not known until the script actually executes.
Example
The following function invocations are equivalent:
Math.atan2(1, 0)
Math.atan2.apply(null, [1, 0])
Method Description
Function.apply()
Invokes the function represented by a Function object, with parameters
passed in through an array.
Function.call()
Invokes the function represented by a Function object.
CHAPTER 6
ActionScript Core Classes