アクション_SWF_5_アクションモデル_スクリプトオブジェクト - hsk/swfspec_ja GitHub Wiki

ActionCallFunction は、関数を実行します。 これには ActionScript の組み込み関数 (parseInt のような) と、ユーザ定義関数、ネイティブ関数が含まれます。 より詳しい情報は ActionNewObject をご覧ください。

ActionCallFunction は次のことを行います。

1. 関数名 (String) をスタックからポップする
2. ''numArgs'' (int) をスタックからポップする
3. 引数をスタックからポップする
4. 引数を渡して、関数を呼び出す
5. 関数の戻り値をスタックにプッシュする 戻り値が無い場合 (関数が return ステートメントを持たない場合)、 push undefined メッセージがコンパイラにより生成され、スタックにプッシュされます。 undefined の戻り値はスタックから取り除かれる必要があります。

全ての呼び出しアクション (ActionCallMethod, ActionNewMethod, ActionNewObject, ActionCallFunction) と初期化アクション (ActionInitObject, ActionInitArray) は、引数が逆の順序でスタックに積まれます。右端の引数が最初に詰まれ、左端の引数が最後に積まれます。 これにより、引数の使用時には順序通りにポップされます。

ActionCallMethod は ActionNewMethod のように、メソッド (関数) をスタックにプッシュします。

名前付きのメソッドが存在する場合、 ActionCallMethod は次のことを行います。

1. メソッドの名前をスタックからポップする メソッド名が空文字列か undefined の場合、 object はメソッドのコンテナオブジェクトではなく、関数オブジェクト (function object) になります。 例えば、 CallMethod が object => obj と空文字のメソッド名で呼び出された場合、次の構文と同等の意味になります。 obj(); メソッド名に foo が指定された時は、 obj.foo(); と同等の意味になります。
2. ScriptObject の ''object'' をスタックからポップする
3. 引数の数 ''args'' をスタックからポップする
4. 引数をスタックからポップする
5. 引数を渡して、メソッドを呼び出す
6. メソッドか関数の戻り値をスタックにプッシュする 戻り値が無い場合 (関数が return ステートメントを持たない場合)、 push undefined メッセージがコンパイラにより生成され、スタックにプッシュされます。 undefined の戻り値はスタックから取り除かれる必要があります。

全ての呼び出しアクション (ActionCallMethod, ActionNewMethod, ActionNewObject, ActionCallFunction) と初期化アクション (ActionInitObject, ActionInitArray) は、引数が逆の順序でスタックに積まれます。右端の引数が最初に詰まれ、左端の引数が最後に積まれます。 これにより、引数の使用時には順序通りにポップされます。

ActionConstantPool は、新しいコンスタントプールを作成します。 古いコンスタントプールが存在する時は上書きされます。

(注)
ActionDefineFunction は SWF 7 以降では滅多に使用されません。
これは ActionDefineFunction2 に置き換えられました。

ActionDefineFunction は、与えられた名前と本体サイズで関数を定義します。

ActionDefineFunction は FunctionName, NumParams, [param1, param2, …, param N], codeSize の順でパースされます。 ActionDefineFunction は、次のことを行います。

1. アクションタグから関数名をパースする
2. タグのパラメータをスキップする
3. タグからコードサイズをパースする DefineFunction タグの後には、 codeSize で指定されたバイト数のアクションデータが続きます。これは、関数の本体になります。
4. 関数用のコードを得る

ActionDefineFunction は、次の方法で使用することができます。

使用法 1 匿名関数をスタックにプッシュします。 この関数は 関数リテラル で、命令文の代わりに式で表現されます。 匿名関数は次のような ActionScript で定義されます。

area = (function () {return Math.PI * radius *radius;})(5);

使用法 2 指定された FunctionName と関数定義により変数をセットします。 こちらは、より慣例的な方法で次のような ActionScript で定義されます。

function Circle(radius) {
　this.radius = radius;
　this.area = Math.PI * radius * radius;
}

ActionDefineLocal は、ローカル変数の定義と値の設定を行います。 変数が既に存在する場合は、新しいもので置き換えられます。

ActionDefineLocal は次のことを行います。

1. 値 (value) をスタックからポップする
2. 名前 (name) をスタックからポップする

ActionDefineLocal2 は、ローカル変数を定義しますが値をセットしません。 変数が既に存在する場合は何も行いません。 ローカル変数の初期値は undefined になります。

ActionDefineLocal2 は次のことを行います。

1. 名前 (name) をスタックからポップする

ActionDelete は名前付きのプロパティを ScriptObject から削除します。

ActionDelete は次のことを行います

1. 削除するプロパティの名前をスタックからポップする
2. プロパティを削除するオブジェクトをスタックからポップする

ActionDelete2 は名前付きのプロパティを削除します。 Flash Player は最初、現在のスコープでプロパティを探します。 見つけられなかった場合、より大きいスコープへと範囲を広げてプロパティを探します。

ActionDelete2 は次のことを行います

1. 削除するプロパティの名前をスタックからポップする

ActionEnumerate は、 ActionScript オブジェクトの全ての "スロット" の名前を取得します。 オブジェクト obj の、全ての名前を表す記号を X とすると、 obj.X のような形式で表されるものを検索します。 ActionEnumerate は、 ActionScript の for .. in 文の実装に使われます。

(注)
特別なスロット名は省略されます。
特別な名前のリストは、 ECMA-262 標準の、 DontEnum の項目を調べてみてください。

リンク

• ''Under Translation of ECMA-262 3rd Edition'' http://www2u.biglobe.ne.jp/~oz-07ams/prog/ecma262r3/
  • ''8 型 (Types)'' http://www2u.biglobe.ne.jp/~oz-07ams/prog/ecma262r3/8_Types.html#section-8.6

ActionEnumerate は次のことを行います。

1. オブジェクト変数の名前 (スラッシュ区切りかドット区切りで表される) をスタックからポップする
2. スロット名のリストの終わりを指すために、 null 値をスタックにプッシュする
3. それぞれのスロット名 (文字列) をスタックにプッシュする

(注)
プッシュする順番は未定義です。

ActionEquals2 は ActionEquals と似ていますが、 ActionEquals2 は型を区別します。 等価比較アルゴリズムは ECMA-262 Section 11.9.3 を使用します。

ActionEquals2 は次のことを行います。

1. arg1 をスタックからポップする
2. arg2 をスタックからポップする
3. 戻り値をスタックにプッシュする

ActionGetMember は、名前付きプロパティをオブジェクトから検索し、そのプロパティの値をスタックにプッシュします。

ActionGetMember は次のことを行います。

1. メンバ関数の名前 ''name'' をスタックからポップする
2. ScriptObject ''object'' をスタックからポップする
3. プロパティの値をスタックにプッシュする

例えば、オブジェクト obj のプロパティ foo に次のように値が割り当てられた時、

obj.foo = 3;

ActionGetMember の object を obj に、 name に foo を指定すると、スタックに 3 をプッシュします。 指定されたプロパティが存在しない時は、 undefined をスタックにプッシュします。

object パラメータは Object 型にする必要はありません。 object パラメータが number, Boolean, string のようなプリミティブ型の場合は、一時的なラッパーオブジェクト Number, Boolean, String へと自動的に変換されます。 これにより、ラッパーオブジェクトのメソッドが、プリミティブ型に対してでも呼び出すことができます。 例えば次の例は、 5 と表示されます。

var x = "Hello";
trace (x.length);

この例の変数 x には、プリミティブ文字列 "Hello" が代入されています。 x は、 String 型のラッパーオブジェクトに一時的にラップされ、その上で length プロパティを取得します。

ActionInitArray は ActionInitObject と同様に、 ScriptObject 内の配列の初期化を行います。 新しく作成されたオブジェクトはスタックにプッシュされます。 スタックには、新しく作成されたオブジェクトの参照のみが積まれます。 ActionInitArray の後に続く SetVariable か SetMember アクションにより、新しく作成されたオブジェクトを変数に代入することができます。

ActionInitArray は要素数 (elems) をスタックからポップした後、 [arg1, arg2, …, argn] をポップします。

ActionInitArray は次のことを行います。

1. 引数 (または要素) の数をスタックからポップする
2. 引数がある場合、 ActionInitArray は、指定された要素数の配列オブジェクトを初期化する
3. ScriptObject として配列を初期化する
4. オブジェクトの型を ''Array'' にセットする
5. スタックから値をポップし、それを配列の初期値として代入する

全ての呼び出しアクション (ActionCallMethod, ActionNewMethod, ActionNewObject, ActionCallFunction) と初期化アクション (ActionInitObject, ActionInitArray) は、引数が逆の順序でスタックに積まれます。右端の引数が最初に詰まれ、左端の引数が最後に積まれます。 これにより、引数の使用時には順序通りにポップされます。

ActionInitObject は ActionInitArray と同じようにオブジェクトを初期化します。 新しく作成されたオブジェクトはスタックにプッシュされます。 スタックには、新しく作成されたオブジェクトの参照のみが積まれます。 ActionInitArray の後に続く SetVariable か SetMember アクションにより、新しく作成されたオブジェクトを変数に代入することができます。

ActionInitObject は要素数 (elems) をスタックからポップした後、 [value1, name1, …, valueN, nameN] をポップします。

ActionInitObject は次のことを行います。

1. 初期プロパティの数をスタックからポップする
2. ScriptObject としてオブジェクトを初期化する
3. オブジェクトの型を Object にセットする
4. 初期プロパティをそれぞれスタックからポップする 各初期プロパティは、最初に値がポップされ、次に名前がポップされます。 名前は文字列に変換されますが、値はどのような型でもかまいません。

全ての呼び出しアクション (ActionCallMethod, ActionNewMethod, ActionNewObject, ActionCallFunction) と初期化アクション (ActionInitObject, ActionInitArray) は、引数が逆の順序でスタックに積まれます。右端の引数が最初に詰まれ、左端の引数が最後に積まれます。 これにより、引数の使用時には順序通りにポップされます。

ActionNewMethod は、新しいオブジェクトを作成するためにコンストラクタ関数を呼び出します。 新しいオブジェクトが作成され、コンストラクタ関数に this キーワードが渡されます。 コンストラクタ関数に引数を指定することもできます。 コンストラクタ関数の戻り値は破棄されます。 ActionCallMethod や ActionNewObject と同じように、新しく作成されたオブジェクトはスタックにプッシュされます。

ActionNewMethod は次のことを行います。

1. メソッドの名前をスタックからポップする
2. ScriptObject をスタックからポップする メソッドの名前が空の場合、 ScriptObject は関数オブジェクトとして扱われ、これをコンストラクタ関数として呼び出します。 メソッドの名前が空でない場合、 ScriptObject 内の、そのメソッドを呼び出します。
3. 引数の数をスタックからポップする
4. メソッド呼び出しを実行する
5. 新しく作成されたオブジェクトをスタックにプッシュする 特定の戻り値が無い場合 (関数が return 文を持たない場合)、コンパイラは push undefined を生成し、それをスタックにプッシュします。 この戻り値の undefined は、スタックからポップされる必要があります。

全ての呼び出しアクション (ActionCallMethod, ActionNewMethod, ActionNewObject, ActionCallFunction) と初期化アクション (ActionInitObject, ActionInitArray) は、引数が逆の順序でスタックに積まれます。右端の引数が最初に詰まれ、左端の引数が最後に積まれます。 これにより、引数の使用時には順序通りにポップされます。

ActionNewObject は、コンストラクタ関数を呼び出します。 新しいオブジェクトが作成され、コンストラクタ関数に this キーワードが渡されます。 オプションで、コンストラクタ関数の引数をスタック上に指定することもできます。 コンストラクタ関数の戻り値は破棄されます。 ActionCallMethod や ActionNewMethod と同じように、新しく作成されたオブジェクトはスタックにプッシュされます。

ActionNewObject は次のことを行います。

1. オブジェクト名 (文字列) ''this'' をスタックからポップする
2. ''numArgs'' (int) をスタックからポップする
3. 引数をスタックからポップする
4. 名前付きオブジェクトのコンストラクタ関数を呼び出す コンストラクタ関数には指定された引数が渡され、新しく作成されたオブジェクトには this キーワードが使われる
5. コンストラクタ関数の戻り値は破棄される
6. 新しく作成されたオブジェクトがスタックにプッシュされる

全ての呼び出しアクション (ActionCallMethod, ActionNewMethod, ActionNewObject, ActionCallFunction) と初期化アクション (ActionInitObject, ActionInitArray) は、引数が逆の順序でスタックに積まれます。右端の引数が最初に詰まれ、左端の引数が最後に積まれます。 これにより、引数の使用時には順序通りにポップされます。

ActionSetMember はオブジェクトのプロパティをセットします。 プロパティが存在していなかった場合は、新しく作成されます。 存在するプロパティが指定された時は上書きされます。

ActionSetMember は次のことを行います。

1. 新しい値をスタックからポップする
2. オブジェクト名をスタックからポップする
3. オブジェクトをスタックからポップする

ActionTargetPath は、指定されたオブジェクトのターゲットパスをスタックにプッシュします。 スタック上のオブジェクトの型が MovieClip の場合、オブジェクトのターゲットパスはドット区切りの表記でスタックにプッシュされます。 オブジェクトの型が MovieClip でない場合、結果はムービークリップのターゲットパスの替わりに undefined になります。

ActionTargetPath は次のことを行います。

1. オブジェクトをスタックからポップする
2. ターゲットパスをスタックにプッシュする

スクリプトの with ブロックを定義します。

ActionWith は次のことを行います。

1. with ブロックを開始するオブジェクトをスタックからポップする
2. ActionWith タグの Size (コードの長さ) をパースする
3. 呼び出しの深さが最大の深さを超えていないかチェックする SWF 6 以降: 最大の深さは 16 SWF 5: 最大の深さは 8 with の深さが最大の深さを上回っている場合、 Size バイトのデータは実行する代わりにスキップされる
4. ActionWith タグの後ろの Size バイトのアクションコードを with ブロックの本体とする
5. with ブロックをスコープチェーンに追加する

• 前のページ : SWF 5 アクション
• 次のページ : 型