XMLList

패키지	최상위 레벨
클래스	public final dynamic class XMLList
상속	XMLList Object

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

XMLList 클래스에는 하나 이상의 XML 요소에 사용되는 메서드가 들어 있습니다. 하나의 XMLList 객체는 하나 이상의 XML 객체 또는 요소(여러 노드 또는 특성 포함)를 나타낼 수 있기 때문에 요소에 있는 메서드를 그룹으로 또는 개별 요소를 컬렉션으로 호출할 수 있습니다.

XMLList 객체에 XML 요소가 하나만 있는 경우 XMLList 객체에서 XML 클래스 메서드를 직접 사용할 수 있습니다. 다음 예제에서 example.two는 길이가 1인 XMLList 객체이므로 모든 XML 메서드를 호출할 수 있습니다.

 var example2 = <example><two>2</two></example>;

두 개 이상의 XML 객체가 들어 있는 XMLList 객체와 함께 XML 클래스 메서드를 사용하려고 하면 예외가 발생합니다. 대신 for each..in 문 등을 사용하여 XMLList 컬렉션을 반복 실행하고 컬렉션의 각 XML 객체에 메서드를 적용합니다.

예제 보기

관련 API 요소

XML
for each..in
Namespace
QName

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		XMLList(value:Object) 새 XMLList 객체를 만듭니다.	XMLList
		attribute(attributeName:*):XMLList 각 XML 객체의 attribute() 메서드를 호출하고 결과의 XMLList 객체를 반환합니다.	XMLList
		attributes():XMLList 각 XML 객체의 attributes() 메서드를 호출하고 각 XML 객체에 대한 특성의 XMLList 객체를 반환합니다.	XMLList
		child(propertyName:Object):XMLList 각 XML 객체의 child() 메서드를 호출하고 결과가 순서대로 포함된 XMLList 객체를 반환합니다.	XMLList
		children():XMLList 각 XML 객체의 children() 메서드를 호출하고 결과가 포함된 XMLList 객체를 반환합니다.	XMLList
		comments():XMLList 각 XML 객체의 comments() 메서드를 호출하고 주석의 XMLList를 반환합니다.	XMLList
		contains(value:XML):Boolean XMLList 객체에 지정된 value 매개 변수와 같은 XML 객체가 포함되어 있는지 확인합니다.	XMLList
		copy():XMLList 지정된 XMLList 객체의 복사본을 반환합니다.	XMLList
		descendants(name:Object = *):XMLList 지정된 name 매개 변수가 있는 XML 객체의 모든 자손(자식, 손자, 증손자 등)을 반환합니다.	XMLList
		elements(name:Object = *):XMLList 각 XML 객체의 elements() 메서드를 호출합니다.	XMLList
		hasComplexContent():Boolean XMLList 객체에 복잡한 내용이 들어 있는지 확인합니다.	XMLList
		hasOwnProperty(p:String):Boolean p에 지정된 속성이 있는지 확인합니다.	XMLList
		hasSimpleContent():Boolean XMLList 객체에 간단한 내용이 들어 있는지 확인합니다.	XMLList
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		length():int XMLList 객체의 속성 수를 반환합니다.	XMLList
		normalize():XMLList 인접한 텍스트 노드를 병합하고 XMLList의 모든 텍스트 노드, XMLList에 포함된 모든 XML 객체 및 XMLList에 포함된 모든 XML 객체의 자손에서 빈 텍스트 노드를 제거합니다.	XMLList
		parent():Object XMLList 객체에 포함된 모든 항목의 부모가 동일한 경우 XMLList 객체의 부모를 반환합니다.	XMLList
		processingInstructions(name:String = "*"):XMLList name 매개 변수를 제공한 경우 XMLList 객체에서 해당 이름의 처리 명령이 포함된 모든 자식을 나열합니다.	XMLList
		propertyIsEnumerable(p:String):Boolean p 속성이 XML 객체에 적용되는 for..in 문에서 반복할 수 있는 속성 집합에 포함되는지 여부를 확인합니다.	XMLList
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		text():XMLList 각 XML 객체의 text() 메서드를 호출하고 결과가 포함된 XMLList 객체를 반환합니다.	XMLList
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String XMLList 객체에 포함된 모든 XML 객체를 표현한 문자열을 반환합니다.	XMLList
		toXMLString():String XMLList 객체에 포함된 모든 XML 객체를 표현한 문자열을 반환합니다.	XMLList
		valueOf():XMLList XMLList 객체를 반환합니다.	XMLList

생성자 세부 정보

()

생성자

public function XMLList(value:Object)

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

새 XMLList 객체를 만듭니다.

매개 변수

value:Object — 최상위 XMLList() 함수를 사용하여 XMLList 객체로 변환할 수 있는 모든 객체입니다.

관련 API 요소

top-level XMLList() 함수

메서드 세부 정보

attribute

()

메서드

AS3 function attribute(attributeName:*):XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

각 XML 객체의 attribute() 메서드를 호출하고 결과의 XMLList 객체를 반환합니다. 그 결과는 지정된 attributeName 매개 변수와 일치합니다. 일치하는 항목이 없으면 attribute() 메서드는 빈 XMLList 객체를 반환합니다.

매개 변수

attributeName:* — XMLList 객체에 포함할 특성 이름입니다.

반환값

XMLList — 일치하는 XML 객체의 XMLList 객체 또는 빈 XMLList 객체입니다.

관련 API 요소

XML.attribute()
XML.attributes()

attributes

()

메서드

AS3 function attributes():XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

각 XML 객체의 attributes() 메서드를 호출하고 각 XML 객체에 대한 특성의 XMLList 객체를 반환합니다.

반환값

XMLList — 각 XML 객체의 특성이 포함된 XMLList 객체입니다.

관련 API 요소

XML.attribute()
XML.attributes()

child

()

메서드

AS3 function child(propertyName:Object):XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

각 XML 객체의 child() 메서드를 호출하고 결과가 순서대로 포함된 XMLList 객체를 반환합니다.

매개 변수

propertyName:Object — XML 자식의 요소 이름 또는 정수입니다.

반환값

XMLList — 입력 매개 변수와 일치하는 자식 노드의 XMLList 객체입니다.

관련 API 요소

XML.child()

children

()

메서드

AS3 function children():XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

각 XML 객체의 children() 메서드를 호출하고 결과가 포함된 XMLList 객체를 반환합니다.

반환값

XMLList — XML 객체의 자식이 포함된 XMLList 객체입니다.

관련 API 요소

XML.children()

comments

()

메서드

AS3 function comments():XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

각 XML 객체의 comments() 메서드를 호출하고 주석의 XMLList를 반환합니다.

반환값

XMLList — XML 객체의 주석이 포함된 XMLList입니다.

관련 API 요소

XML.comments()

contains

()

메서드

AS3 function contains(value:XML):Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

XMLList 객체에 지정된 value 매개 변수와 같은 XML 객체가 포함되어 있는지 확인합니다.

매개 변수

value:XML — 현재 XMLList 객체와 비교할 XML 객체입니다.

반환값

Boolean — value 매개 변수로 선언한 XML 객체가 XMLList에 포함되어 있으면 true이고, 그렇지 않으면 false입니다.

copy

()

메서드

AS3 function copy():XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

지정된 XMLList 객체의 복사본을 반환합니다. 이 복사본은 노드 트리 전체를 복제한 것입니다. 복사된 XML 객체에는 부모가 없으며 parent() 메서드를 호출하면 null이 반환됩니다.

반환값

XMLList — XMLList 객체의 복사본입니다.

descendants

()

메서드

AS3 function descendants(name:Object = *):XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

지정된 name 매개 변수가 있는 XML 객체의 모든 자손(자식, 손자, 증손자 등)을 반환합니다. name 매개 변수는 QName 객체, String 데이터 유형 또는 나중에 String 데이터 유형으로 변환되는 기타 모든 데이터 유형이 될 수 있습니다.

모든 자손을 반환하려면 별표(*) 매개 변수를 사용합니다. 매개 변수를 전달하지 않으면 "*" 문자열이 전달되고 XML 객체의 모든 자손이 반환됩니다.

매개 변수

name:Object (default = *) — 비교할 요소 이름입니다.

반환값

XMLList — 원래 목록에 있는 XML 객체의 일치하는 자손(자식, 손자 등)이 포함된 XMLList 객체입니다. 자손이 없으면 빈 XMLList 객체가 반환됩니다.

관련 API 요소

XML.descendants()

elements

()

메서드

AS3 function elements(name:Object = *):XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

각 XML 객체의 elements() 메서드를 호출합니다. name 매개 변수가 descendants() 메서드에 전달됩니다. 매개 변수를 전달하지 않으면 "*" 문자열이 descendants() 메서드에 전달됩니다.

매개 변수

name:Object (default = *) — 비교할 요소의 이름입니다.

반환값

XMLList — XML 객체의 일치하는 자식 요소가 포함된 XMLList 객체입니다.

관련 API 요소

XML.elements()

hasComplexContent

()

메서드

AS3 function hasComplexContent():Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

XMLList 객체에 복잡한 내용이 들어 있는지 확인합니다. XMLList 객체가 비어 있지 않고 다음 조건 중 하나가 참이면 복잡한 내용이 들어 있는 것으로 간주됩니다.

XMLList 객체에 복잡한 내용이 포함된 XML 항목 하나가 들어 있는 경우
XMLList 객체에 요소가 포함된 경우

반환값

Boolean — XMLList 객체에 복잡한 내용이 들어 있으면 true이고, 그렇지 않으면 false입니다.

hasOwnProperty

()

메서드

AS3 function hasOwnProperty(p:String):Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

p에 지정된 속성이 있는지 확인합니다.

매개 변수

p:String — 비교할 속성입니다.

반환값

Boolean — 매개 변수가 있으면 true이고, 그렇지 않으면 false입니다.

hasSimpleContent

()

메서드

AS3 function hasSimpleContent():Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

XMLList 객체에 간단한 내용이 들어 있는지 확인합니다. 다음 조건 중 하나 이상이 참이면 XMLList 객체에 간단한 내용이 들어 있는 것으로 간주됩니다.

XMLList 객체가 비어 있는 경우
XMLList 객체에 간단한 내용이 포함된 XML 항목 하나가 들어 있는 경우
XMLList 객체에 요소가 없는 경우

반환값

Boolean — XMLList에 간단한 내용이 들어 있으면 true이고, 그렇지 않으면 false입니다.

length

()

메서드

AS3 function length():int

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

XMLList 객체의 속성 수를 반환합니다.

반환값

int — XMLList 객체의 속성 수입니다.

normalize

()

메서드

AS3 function normalize():XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

인접한 텍스트 노드를 병합하고 XMLList의 모든 텍스트 노드, XMLList에 포함된 모든 XML 객체 및 XMLList에 포함된 모든 XML 객체의 자손에서 빈 텍스트 노드를 제거합니다.

반환값

XMLList — 정규화된 XMLList 객체입니다.

parent

()

메서드

AS3 function parent():Object

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

XMLList 객체에 포함된 모든 항목의 부모가 동일한 경우 XMLList 객체의 부모를 반환합니다. XMLList 객체에 부모가 없거나 부모가 서로 다른 경우 이 메서드는 undefined를 반환합니다.

반환값

Object — 부모 XML 객체를 반환합니다.

processingInstructions

()

메서드

AS3 function processingInstructions(name:String = "*"):XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

name 매개 변수를 제공한 경우 XMLList 객체에서 해당 이름의 처리 명령이 포함된 모든 자식을 나열합니다. 매개 변수를 제공하지 않으면 이 메서드는 XMLList 객체에서 처리 명령이 하나라도 포함된 자식을 모두 나열합니다.

매개 변수

name:String (default = "*") — 비교할 처리 명령의 이름입니다.

반환값

XMLList — 각 XML 객체의 처리 명령이 포함된 XMLList 객체입니다.

관련 API 요소

XML.processingInstructions()

propertyIsEnumerable

()

메서드

AS3 function propertyIsEnumerable(p:String):Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

p 속성이 XMLList 객체에 적용되는 for..in 문에서 반복할 수 있는 속성 집합에 포함되는지 여부를 확인합니다. toNumber(p)가 0보다 크거나 같고 XMLList 객체의 길이보다 작은 경우에만 true입니다.

매개 변수

p:String — 확인할 속성의 인덱스입니다.

반환값

Boolean — for..in 문에서 속성을 반복할 수 있으면 true이고, 그렇지 않으면 false입니다.

text

()

메서드

AS3 function text():XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

각 XML 객체의 text() 메서드를 호출하고 결과가 포함된 XMLList 객체를 반환합니다.

반환값

XMLList — XML 텍스트 노드를 나타내는 XMLList 객체의 모든 XML 속성이 포함된 XMLList 객체입니다.

관련 API 요소

XML.text()

toString

()

메서드

AS3 function toString():String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

XMLList 객체에 포함된 모든 XML 객체를 표현한 문자열을 반환합니다. 이 변환의 규칙은 XML 객체의 내용이 간단한지 복잡한지에 따라 다릅니다.

XML 객체의 내용이 간단하면 toString()은 시작 태그, 특성, 네임스페이스 선언 및 끝 태그를 제외한 XML 객체의 문자열 내용을 반환합니다.

XML 객체의 내용이 복잡하면 toString()은 시작 태그, 특성, 네임스페이스 선언 및 끝 태그를 포함하여 XML 객체 전체를 나타내는 XML 인코딩 문자열을 반환합니다.

항상 XML 객체 전체를 반환하려면 toXMLString() 메서드를 사용합니다.

반환값

String — XML 객체의 문자열 표현입니다.

예제 ( 예제 사용 방법 )

다음 예제에서는 XML 객체의 내용이 간단한 경우에 toString() 메서드가 반환하는 내용을 보여 줍니다.

var test:XML = <type name="Joe">example</type>;
trace(test.toString()); //example

다음 예제에서는 XML 객체의 내용이 복잡한 경우에 toString() 메서드가 반환하는 내용을 보여 줍니다.

var test:XML = 
<type name="Joe">
    <base name="Bob"></base>
    example
</type>;
trace(test.toString());
  // <type name="Joe">
  // <base name="Bob"/>
  // example
  // </type>

toXMLString

()

메서드

AS3 function toXMLString():String

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

XMLList 객체에 포함된 모든 XML 객체를 표현한 문자열을 반환합니다. toString() 메서드와 달리 toXMLString() 메서드는 XML 객체의 내용이 간단한지 복잡한지에 관계없이 항상 XML 객체의 시작 태그, 특성 및 끝 태그를 반환합니다. toString() 메서드는 XML 객체에 간단한 내용이 포함되어 있는 경우 이러한 항목을 제거합니다.

반환값

String — XML 객체의 문자열 표현입니다.

관련 API 요소

toString()

valueOf

()

메서드

AS3 function valueOf():XMLList

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

XMLList 객체를 반환합니다.

반환값

XMLList — 현재 XMLList 객체를 반환합니다.

예제 예제 사용 방법

XMLListExample.as

다음 예제에서는 books라는 XML 속성을 만들고 books라는 노드에 book publisher 및 name 태그가 있는 여러 항목을 추가합니다. showBooksByPublisher() 메서드를 호출하여 XMLList를 가져온 다음 "Addison-Wesley" 출판사와 일치하는 각 항목을 반환합니다.

package {
    import flash.display.Sprite;

    public class XMLListExample extends Sprite {
        private var books:XML;

        public function XMLListExample() {
            books =    <books>
                        <book publisher="Addison-Wesley" name="Design Patterns" />
                        <book publisher="Addison-Wesley" name="The Pragmatic Programmer" />
                        <book publisher="Addison-Wesley" name="Test Driven Development" />
                        <book publisher="Addison-Wesley" name="Refactoring to Patterns" />
                        <book publisher="O'Reilly Media" name="The Cathedral & the Bazaar" />
                        <book publisher="O'Reilly Media" name="Unit Test Frameworks" />
                    </books>;

            showBooksByPublisher("Addison-Wesley");
        }

        private function showBooksByPublisher(name:String):void {
            var results:XMLList = books.book.(@publisher == name);
            showList(results);
        }

        private function showList(list:XMLList):void {
            var item:XML;
            for each(item in list) {
                trace("item: " + item.toXMLString());
            }
        }
    }
}

법적 고지 사항 | 온라인 개인 정보 보호 정책

XMLList - AS3

클래스 x

XMLList

attribute

attributes

child

children

comments

contains

copy

descendants

elements

hasComplexContent

hasOwnProperty

hasSimpleContent

length

normalize

parent

processingInstructions

propertyIsEnumerable

text

toString

toXMLString

valueOf