Dictionary

패키지	flash.utils
클래스	public dynamic class Dictionary
상속	Dictionary Object

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

Dictionary 클래스를 사용하면 키 비교에 strict equality(===)를 사용하는 동적 속성 컬렉션을 만들 수 있습니다. 객체를 키로 사용하는 경우 객체에 toString()을 호출하여 반환되는 값이 아니라 객체의 ID가 객체를 찾는 데 사용됩니다.

참고: QName 객체를 사전 키로 사용할 수는 없습니다.

다음 명령문은 Dictionary 객체와 키 객체 사이의 관계를 보여 줍니다.

 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 객체에 있는 참조가 객체에 대한 유일한 참조인 경우 해당 키를 가비지 수집에 사용할 수 있고 객체가 수집될 때 테이블에서 키가 제거됩니다. Dictionary는 약한 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()가 발견하는 각 값마다 해당 메서드를 호출하여 값과 쌍을 이루는 키에 전달합니다.

Dictionary는 단순히 클래스 이름을 반환하는 기본 toJSON() 구현을 제공합니다. Dictionary 객체를 JSON으로 내보내려는 고객은 고객만의 toJSON() 구현을 제공해야 합니다. 이는 클래스 프로토타입에 toJSON() 메서드를 다시 정의하는 방식으로 수행하면 됩니다.

toJSON() 메서드는 어떤 유형의 값도 반환할 수 있습니다. 객체를 반환하면 stringify()가 해당 객체로 회귀하고, toJSON()이 문자열을 반환하면 stringify()가 회귀하지 않고 탐색을 계속 진행합니다.

매개 변수

k:String — JSON.stringify()가 이 객체를 탐색할 때 발견하는 키/값 쌍의 키입니다.

반환값

* — 클래스 이름 문자열입니다.

Dictionary - AS3

클래스 x

Dictionary

toJSON