return

Availability

Flash Player 5.

Usage

return[expression]

Parameters

expression A string, number, array, or object to evaluate and return as a value of the function. This parameter is optional.

Returns

The evaluated expression parameter, if provided.

Description

Statement; specifies the value returned by a function. The return action evaluates expression and returns the result as a value of the function in which it executes. The return action causes the function to stop running and replaces the function with the returned value. If the return statement is used alone, it returns null.

You can't return multiple values. If you try to do so, only the last value is returned. In the following example, c is returned:

return a, b, c ;

Example

The following example uses the return action inside the body of the sum() function to return the added value of the three parameters. The next line of code calls sum() and assigns the returned value to the variable newValue.

function sum(a, b, c){
  return a + b + c;
}
newValue = sum(4, 32, 78);
trace(newValue);
// sends 114 to the Output panel

See also

function