Adobe® Flash® Platform용 ActionScript® 3.0 참조 설명서
 |  패키지 및 클래스 목록 숨기기 |  패키지  |  클래스  |  새로운 내용  |  색인  |  부록  |  영어로 표시되는 이유
필터: 서버에서 데이터를 검색하는 중...
서버에서 데이터를 검색하는 중...
flash.utils 

Dictionary  - AS3

패키지flash.utils
클래스public dynamic class Dictionary
상속Dictionary Inheritance 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 요소



공용 속성
 속성정의 주체
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
공용 메서드
 메서드정의 주체
  
Dictionary(weakKeys:Boolean = false)
새 Dictionary 객체를 만듭니다.
Dictionary
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
  
Dictionary 객체의 JSON 인코딩 값을 사용자 정의할 수 있도록 재정의 가능한 메서드를 제공합니다.
Dictionary
 Inherited
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
생성자 세부 정보

Dictionary

()생성자
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:StringJSON.stringify()가 이 객체를 탐색할 때 발견하는 키/값 쌍의 키입니다.

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

관련 API 요소

Object
Object.prototype




[ X ]영어로 표시되는 이유
ActionScript 3.0 참조 설명서의 내용이 영어로 나타납니다.

ActionScript 3.0 참조 설명서 중 일부는 전체 언어로 번역되지 않았습니다. 언어 요소가 번역되지 않은 경우 영어로 나타납니다. 예를 들어 ga.controls.HelpBox 클래스는 어떤 언어로도 번역되지 않았습니다. 그러므로 한국어 버전의 참조 설명서에서 ga.controls.HelpBox 클래스는 영어로 나타납니다.