function ステートメント

Usage 1: (Declares a named function.)
function functionname([parameter0, parameter1,...parameterN]){
statement(s)
}
Usage 2: (Declares an anonymous function and returns a reference to it.)
function ([parameter0, parameter1,...parameterN]){ 
statement(s)
}

何らかのタスクを実行するために定義する一連のステートメントで構成されます。ある位置で関数を定義し、SWF ファイルの異なるスクリプトからその関数を呼び出すことができます。関数を定義する場合、その関数のパラメータも指定できます。パラメータは、関数が処理する値のプレースホルダーです。関数を呼び出すたびに異なるパラメータを渡すことができます。これにより、1 つの関数を多くの異なる状況で再利用できます。

関数で値を生成する、つまり "返す" には、関数の statement(s) で return ステートメントを使用します。

このステートメントを使用して、functionname、parameters、および statement(s) が指定された function を定義します。スクリプトによって関数が呼び出されると、関数定義内のステートメントが実行されます。関数は前方参照が許されます。つまり、同じスクリプト内では、関数を呼び出す箇所よりも後に関数を宣言できます。関数定義は、同じ関数の以前の定義と置き換わります。ステートメントが許されている場所であればどこでも、このシンタックスを使用できます。

この関数ステートメントを使用して匿名関数を作成し、その関数への参照を返すことができます。このシンタックスは式の中で使用され、特にオブジェクト内にメソッドを組み込む場合に便利です。

さらに、関数定義内で arguments オブジェクトを使用することができます。一般に、arguments オブジェクトは、可変数のパラメータを受け取る関数や再帰的な匿名関数を作成する場合に使用します。

戻り値

String - シンタックス 1 : この宣言形式では何も返されません。シンタックス 2 : 匿名関数への参照。

パラメータ

例

次の例では、1 つのパラメータを受け取る関数 sqr を定義し、そのパラメータの Math.pow(x, 2) を返します。

function sqr(x:Number) { 
 return Math.pow(x, 2); 
} 
var y:Number = sqr(3); 
trace(y); // output: 9

同じスクリプト内で関数を定義および使用する場合は、関数の使用箇所の後に関数定義を記述することもできます。

var y:Number = sqr(3); 
trace(y); // output: 9 
function sqr(x:Number) { 
 return Math.pow(x, 2); 
}

次の関数は、LoadVars オブジェクトを作成し、params.txt を SWF ファイルにロードします。ファイルが正常にロードされると、"variables loaded" と表示されます。

var myLV:LoadVars = new LoadVars(); 
myLV.load("params.txt"); 
myLV.onLoad = function(success:Boolean) { 
 trace("variables loaded"); 
}