XMLList (Flex™ 2 레퍼런스 가이드)

XML Methods
`addNamespace()`
`appendChild()`
`childIndex()`
`inScopeNamespace()`
`insertChildAFter()`
`insertChildBefore()`
`name()`
`namespace()`
`localName()`
`namespaceDeclarations()`
`nodeKind()`
`prependChild()`
`removeNamespace()`
`replace()`
`setChildren()`
`setLocalName()`
`setName()`
`setNamespace()`

	property	정의
		constructor : Object 특정의 object 인스턴스의 클래스 object 또는 constructor　　 함수에의 참조입니다.	Object
		prototype : Object [static] 클래스 또는 함수 object의 prototype object에의 참조입니다.	Object

	Methods	정의
		XMLList (value:Object ) 새로운 XMLList object를 작성합니다.	XMLList
		attribute (attributeName:* ):XMLList 각 XML object의 `attribute()` Methods를 호출해, 그 결과의 XMLList object를 돌려줍니다.	XMLList
		attributes ():XMLList 각 XML object의 `attributes()` Methods를 호출해, 각 XML object의 속성의 XMLList object를 돌려줍니다.	XMLList
		child (propertyName:Object ):XMLList 각 XML object의 `child()` Methods를 호출해, 그 결과를 순서에 포함한 XMLList object를 돌려줍니다.	XMLList
		children ():XMLList 각 XML object의 `children()` Methods를 호출해, 그 결과를 포함한 XMLList object를 돌려줍니다.	XMLList
		comments ():XMLList 각 XML object의 `comments()` Methods를 호출해, 코멘트의 XMLList 를 돌려줍니다.	XMLList
		contains (value:XML ):Boolean 지정된 `value` Parameters에 동일한 XML object가 XMLList object에 포함될지 어떨지를 확인합니다.	XMLList
		copy ():XMLList 지정된 XMLList object의 복사를 돌려줍니다.	XMLList
		descendants (name:Object = *):XMLList 지정된 `name` Parameters를 가지는 XML object의 모든 자손 (자, 손자, 히 손자등)을 돌려줍니다.	XMLList
		elements (name:Object = *):XMLList 각 XML object의 `elements()` Methods를 호출합니다.	XMLList
		hasComplexContent ():Boolean XMLList object에 복합 내용이 포함될지 어떨지를 확인합니다.	XMLList
		hasOwnProperty (p:String ):Boolean `p` 에 의해 지정된 property를 체크합니다.	XMLList
		hasSimpleContent ():Boolean XMLList object에 단순 내용이 포함될지 어떨지를 확인합니다.	XMLList
		isPrototypeOf (theClass:Object ):Boolean Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.	Object
		length ():int XMLList object내의 property수를 돌려줍니다.	XMLList
		normalize ():XMLList 인접하는 텍스트 노드를 결합해, XMLList 내의 모든 텍스트 노드, XMLList 에 포함되는 모든 XML object, 및 XMLList 내의 모든 XML object의 자손에 대해, 각각 empty의 텍스트 노드를 삭제합니다.	XMLList
		parent ():Object XMLList object내의 모든 아이템이 같은 부모를 가지는 경우, XMLList object의 부모를 돌려줍니다.	XMLList
		processingInstructions (name:String = "*"):XMLList `name` Parameters를 지정했을 경우, 그 이름을 가지는 처리 인스트럭션을 포함한 XMLList object의 모든 아이를 일람표 가리킵니다.	XMLList
		propertyIsEnumerable (p:String ):Boolean XMLList object에 적용되는 `for..in` 명령문(statement)내에서 반복 처리되는 property 세트내에, property `p` 가 있을지 어떨지를 확인합니다.	XMLList
		setPropertyIsEnumerable (name:String , isEnum:Boolean = true):void 루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.	Object
		text ():XMLList 각 XML object의 `text()` Methods를 호출해, 그 결과를 포함한 XMLList object를 돌려줍니다.	XMLList
		toString ():String XMLList object내의 모든 XML object의 string 표현을 돌려줍니다.	XMLList
		toXMLString ():String XMLList object내의 모든 XML object의 string 표현을 돌려줍니다.	XMLList
		valueOf ():XMLList XMLList object를 돌려줍니다.	XMLList

constructor　　 의 상세

XMLList

()

constructor　　

public 함수 XMLList(value:Object )

새로운 XMLList object를 작성합니다.

Parameters

value:Object — 톱 레벨 함수 XMLList() 에 의해 XMLList object에 변환 가능한 object입니다.

See also

top-level XMLList() function

Methods의 상세

attribute

()

Methods

AS3 function attribute(attributeName:* ):XMLList

각 XML object의 attribute() Methods를 호출해, 그 결과의 XMLList object를 돌려줍니다. 이 결과는, 지정된 attributeName Parameters에 일치합니다. 일치하는 XML object가 없었던 경우,attribute() Methods는 empty의 XMLList object를 돌려줍니다.

Parameters

attributeName:* — XMLList object내에 포함하는 속성의 이름입니다.

반환값

XMLList — XML object가 일치하는 XMLList object, 또는 empty의 XMLList object입니다.

attributes

()

Methods

AS3 function attributes():XMLList

각 XML object의 attributes() Methods를 호출해, 각 XML object의 속성의 XMLList object를 돌려줍니다.

반환값

XMLList — 각 XML object의 속성의 XMLList object입니다.

child

()

Methods

AS3 function child(propertyName:Object ):XMLList

각 XML object의 child() Methods를 호출해, 그 결과를 순서에 포함한 XMLList object를 돌려줍니다.

Parameters

propertyName:Object — XML 의 아이의 엘리먼트명 또는 정수입니다.

반환값

XMLList — 입력 Parameters에 일치하는 child 노드의 XMLList object입니다.

See also

XML.child()
XMLList object

children

()

Methods

AS3 function children():XMLList

각 XML object의 children() Methods를 호출해, 그 결과를 포함한 XMLList object를 돌려줍니다.

반환값

XMLList — XML object내의 child (복수)의 XMLList object입니다.

See also

XML.children()
XMLList object

comments

()

Methods

AS3 function comments():XMLList

각 XML object의 comments() Methods를 호출해, 코멘트의 XMLList 를 돌려줍니다.

반환값

XMLList — XML object내의 코멘트의 XMLList 입니다.

See also

XML.comments()
XMLList object

contains

()

Methods

AS3 function contains(value:XML ):Boolean

지정된 value Parameters에 동일한 XML object가 XMLList object에 포함될지 어떨지를 확인합니다.

Parameters

value:XML — 현재의 XMLList object와 비교하는 XML object입니다.

반환값

Boolean — value Parameters로 선언된 XML object가 XMLList object에 포함되는 경우는 true, 그 이외의 경우는 false 를 돌려줍니다.

See also

XMLList object

copy

()

Methods

AS3 function copy():XMLList

지정된 XMLList object의 복사를 돌려줍니다. 복사와는 노드의 트리 전체의 복제입니다. 복사된 XML object에는 부모는 없고,parent() Methods를 호출하려고 하면 null 가 돌려주어집니다.

반환값

XMLList — XMLList object의 복사입니다.

See also

XMLList object

descendants

()

Methods

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

지정된 name Parameters를 가지는 XML object의 모든 자손 (자, 손자, 히 손자등)을 돌려줍니다. name Parameters에는, QName object, String 데이터형, 또는 다른 임의의 데이터형 (다음에 String 데이터형에 변환됩니다)을 지정할 수 있습니다.

모든 자손을 돌려주려면 , asterisk (*) Parameters를 사용합니다. Parameters를 지정하지 않는 경우는 string "*" 가 건네받아 XML object의 모든 자손이 돌려주어집니다.

Parameters

name:Object (default = *) — 조합하는 엘리먼트의 이름입니다.

반환값

XMLList — 원의 리스트내의 일치하는 XML object의 자손 (아이, 손자등)의 XMLList object입니다. 자손이 없는 경우는, empty의 XMLList object를 돌려줍니다.

See also

XML.descendants()
XMLList object

elements

()

Methods

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

각 XML object의 elements() Methods를 호출합니다. name Parameters가 descendants() Methods에게 건네집니다. Parameters가 건네받지 않았던 경우, string "*" 가 descendants() Methods에게 건네집니다.

Parameters

name:Object (default = *) — 조합하는 엘리먼트의 이름입니다.

반환값

XMLList — 일치하는 XML object의 child 엘리먼트의 XMLList object입니다.

See also

XML.elements()

hasComplexContent

()

Methods

AS3 function hasComplexContent():Boolean

XMLList object에 복합 내용이 포함될지 어떨지를 확인합니다. XMLList object가 empty이 아니고, 다음의 몇개의 조건이 true 의 경우에, XMLList object는 복합 내용을 가진다고 보여집니다.

XMLList object에, 복합 내용을 가지는 1 개의 XML 아이템이 포함되어 있다.
XMLList object에 복수의 엘리먼트가 포함되어 있다.

반환값

Boolean — XMLList object에 복합 내용이 포함되는 경우는 true, 그 이외의 경우는 false 를 돌려줍니다.

hasOwnProperty

()

Methods

AS3 function hasOwnProperty(p:String ):Boolean

p 에 의해 지정된 property를 체크합니다.

Parameters

p:String — 조합하는 property입니다.

반환값

Boolean — Parameters가 존재하는 경우는 true, 그 이외의 경우는 false 를 돌려줍니다.

See also

XMLList object

hasSimpleContent

()

Methods

AS3 function hasSimpleContent():Boolean

XMLList object에 단순 내용이 포함될지 어떨지를 확인합니다. 다음의 몇개의 조건이 true 의 경우에, XMLList object는 단순 내용을 가진다고 보여집니다.

XMLList object가 empty이다.
XMLList object에, 단순 내용을 가지는 1 개의 XML 아이템이 포함되어 있다.
XMLList object에 엘리먼트가 포함되지 않았다.

반환값

Boolean — XMLList 에 단순 내용이 포함되는 경우는 true, 그 이외의 경우는 false 를 돌려줍니다.

length

()

Methods

AS3 function length():int

XMLList object내의 property수를 돌려줍니다.

반환값

int — XMLList object내의 property수입니다.

See also

XMLList object

normalize

()

Methods

AS3 function normalize():XMLList

인접하는 텍스트 노드를 결합해, XMLList 내의 모든 텍스트 노드, XMLList 에 포함되는 모든 XML object, 및 XMLList 내의 모든 XML object의 자손에 대해, 각각 empty의 텍스트 노드를 삭제합니다.

반환값

XMLList — 정규화한 XMLList object입니다.

See also

XMLList object

parent

()

Methods

AS3 function parent():Object

XMLList object내의 모든 아이템이 같은 부모를 가지는 경우, XMLList object의 부모를 돌려줍니다. XMLList object가 부모를 가지지 않는가, 다른 부모를 가지는 경우, Methods는 undefined 돌려줍니다.

반환값

Object — 친 XML object를 돌려줍니다.

See also

XMLList object

processingInstructions

()

Methods

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

name Parameters를 지정했을 경우, 그 이름을 가지는 처리 인스트럭션을 포함한 XMLList object의 모든 아이를 일람표 가리킵니다. Parameters를 지정하지 않았던 경우, Methods는 임의의 처리 인스트럭션을 포함한 XMLList object의 모든 아이를 일람표 가리킵니다.

Parameters

name:String (default = "*") — 조합하는 처리 인스트럭션의 이름입니다.

반환값

XMLList — 각 XML object의 처리 인스트럭션을 포함한 XMLList object입니다.

propertyIsEnumerable

()

Methods

AS3 function propertyIsEnumerable(p:String ):Boolean

XMLList object에 적용되는 for..in 명령문(statement)내에서 반복 처리되는 property 세트내에, property p 가 있을지 어떨지를 확인합니다. 이것은,toNumber(p) 가 0 보다 큰가 동일하고, 한편 XMLList object의 길이보다 작은 경우에 한정해 true 를 돌려줍니다.

Parameters

p:String — 확인하는 property의 인덱스입니다.

반환값

Boolean — for..in 명령문(statement)내에서 property를 반복 처리할 수 있는 경우는 true, 그 이외의 경우는 false 를 돌려줍니다.

See also

XMLList object

text

()

Methods

AS3 function text():XMLList

각 XML object의 text() Methods를 호출해, 그 결과를 포함한 XMLList object를 돌려줍니다.

반환값

XMLList — XML 텍스트 노드를 나타내는 XMLList object의 모든 XML property의 XMLList object입니다.

See also

XML.text()
XMLList object

toString

()

Methods

AS3 function toString():String

XMLList object내의 모든 XML object의 string 표현을 돌려줍니다. 이 변환의 규칙은, XML object에 단순 내용이 포함되는지, 복합 내용이 포함될까에 의해 정해집니다.

XML object에 단순 내용이 포함되는 경우,toString() 는, XML object의 string 내용으로부터 개시 태그, 속성, namespace 선언, 및 종료 태그를 삭제합니다.

XML object에 복합 내용이 포함되는 경우,toString() 는, 개시 태그, 속성, namespace 선언, 및 종료 태그를 포함한 XML object 전체를 나타내는, XML encode 된 string를 돌려줍니다.

XML object 전체를 매회 돌려주려면 ,toXMLString() Methods를 사용합니다.

반환값

String — XML object의 string 표현입니다.

Example
다음의 예는, XML object에 복합 내용이 포함되는 경우에, toString() Methods가 무엇을 돌려주는지를 나타내고 있습니다.

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

다음의 예는, XML object에 복합 내용이 포함되는 경우에, toString() Methods가 무엇을 돌려주는지를 나타내고 있습니다.

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

toXMLString

()

Methods

AS3 function toXMLString():String

XMLList object내의 모든 XML object의 string 표현을 돌려줍니다. toString() Methods와는 달라,toXMLString() Methods는, XML object에 단순 내용이 포함되는지, 복합 내용이 포함될까에 관계없이, 항상 XML object의 개시 태그, 속성, 및 종료 태그를 돌려줍니다. toString() Methods는, 단순 내용을 가지는 XML object의 개시 태그, 속성, 및 종료 태그를 삭제합니다.

반환값

String — XML object의 string 표현입니다.

See also

toString()
XMLList object
XML 의 형태 변환

valueOf

()

Methods

AS3 function valueOf():XMLList

XMLList object를 돌려줍니다.

반환값

XMLList — 현재의 XMLList object를 돌려줍니다.

See also

XMLList object

Examples

다음의 예에서는,books 라는 이름의 XML property를 작성해, book publisher 태그와 name 태그를 가지는 몇개의 아이템을 books 라는 이름의 노드에 추가합니다. 다음에,showBooksByPublisher() Methods를 호출합니다. 이 Methods는 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());
            }
        }
    }
}

Adobe® Flex™ 2 Language Reference		모든 패키지 \| 모든 클래스 \| 언어 엘리먼트 \| 색인 \| 부록 \| 규칙 \| 프레임내에 표시 프레임 없음 버젼
Class XMLList	property \| Methods \| 예

Package	톱 레벨
Class	public final dynamic class XMLList
Inheritance	XMLList Object