See Also                    Methods                    Properties

Description

Creates a new function.

Syntax 1

function functionname( [argname1 [, ... argnameN]] )
{
    body
}

Syntax 2

var functionname = new Function( [argname1, [... argnameN,]] body );

The Function object syntax has these parts:

Part	Description
functionname	The name of the newly created function
argname1...argnameN	An optional list of arguments that the function accepts.
body	A string that contains the block of JavaScript code to be executed when the function is called.

Remarks

The function is a basic data type in JScript. Syntax 1 creates a function value that JavaScript converts into a Function object when necessary. JavaScript converts Function objects created by Syntax 2 into function values at the time the function is called.

Syntax 1 is the standard way to create new functions in JScript. Syntax 2 is an alternative form used to create function objects explicitly.

For example, to create a function that adds the two arguments passed to it, you can do it in either of two ways:

Example 1

function add(x, y)
{
   return(x + y);
}

Example 2

var add = new Function("x", "y", "return(x+y)");

In either case, you call the function with a line of code similar to the following:

add(2, 3);

Note  When calling a function, ensure that you always include the parentheses and any required arguments. Calling a function without parentheses causes the text of the function to be returned instead of the results of the function.