Dictionary

パッケージ	flash.utils
クラス	public dynamic class Dictionary
継承	Dictionary Object

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

Dictionary クラスでは、プロパティの動的なコレクションを作成し、キーの比較に厳密な等式（===）を使用できます。オブジェクトがキーとして使用されている場合は、オブジェクトの識別子を使用してオブジェクトを検索し、オブジェクトの toString() を呼び出して返される値は使用されません。

注意： QName オブジェクトを Dictionary キーとして使用することはできません。

次のステートメントは、Dictionary オブジェクトと Key オブジェクトの関係を示します。

 var dict = new Dictionary();
 var obj = new Object();
 var key:Object = new Object();
 key.toString = function() { return "key" }
 
 dict[key] = "Letters";
 obj["key"] = "Letters";
 
 dict[key] == "Letters"; // true
 obj["key"] == "Letters"; // true
 obj[key] == "Letters"; // true because key == "key" is true b/c key.toString == "key"
 dict["key"] == "Letters"; // false because "key" === key is false
 delete dict[key]; //removes the key

関連する API エレメント

=== (strict equality)

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		Dictionary(weakKeys:Boolean = false) 新しい Dictionary オブジェクトを作成します。	Dictionary
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toJSON(k:String):* Dictionary オブジェクトの値の JSON エンコーディングをカスタマイズするためのオーバーライド可能なメソッドです。	Dictionary
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object

コンストラクターの詳細

()

コンストラクター

public function Dictionary(weakKeys:Boolean = false)

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

新しい Dictionary オブジェクトを作成します。Dictionary オブジェクトからキーを削除するには、delete 演算子を使用します。

パラメーター

weakKeys:Boolean (default = false) — オブジェクトキーに "弱" 参照を使用するように、Dictionary オブジェクトに指示します。オブジェクトへの唯一の参照が、指定した Dictionary オブジェクトにある場合は、そのキーがガベージコレクションの対象となり、オブジェクトが収集されるときにテーブルから削除されます。ただし、Dicrionary が表から弱い String キーを削除することはありません。特に、String キーの場合、弱い参照がキー表から削除されることはなく、Dictionary は対応する値への強い参照を保持し続けます。

メソッドの詳細

toJSON

()

メソッド

public function toJSON(k:String):*

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 11, AIR 3, Flash Lite 4

Dictionary オブジェクトの値の JSON エンコーディングをカスタマイズするためのオーバーライド可能なメソッドです。

JSON.stringify() メソッドは、スキャンする各オブジェクトの toJSON() メソッドを検索します。toJSON() が見つかれば、JSON.stringify() で検出された値ごとに toJSON() メソッドが呼び出され、値のペアとなっているキーが渡されます。

Dictionary には、単純にクラス名を返すデフォルトの toJSON() 実装が含まれています。Dictionary オブジェクトを JSON に書き出す場合は、独自の toJSON() 実装を行う必要があります。このためには、クラスのプロトタイプの toJSON() メソッドを再定義します。

toJSON() メソッドは、あらゆるタイプの値を返すことができます。オブジェクトを返す場合は、stringify() でそのオブジェクトが再帰的に処理されます。toJSON() が文字列を返す場合は、stringify() で再帰的な処理は行われず、オブジェクトをスキャンする処理が続行されます。

パラメーター

k:String — JSON.stringify() がこのオブジェクトをスキャンして検出されたキーと値のペアのキーです。

戻り値

* — クラス名の文字列です。

Dictionary - AS3

クラス x

Dictionary

toJSON