| Player 버전 : | Flash Player 9 |
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 객체에 메서드를 적용합니다.
예제를 통해 확인하십시오.
public function XMLList(value:Object)
| Player 버전 : | Flash Player 9 |
새 XMLList 객체를 만듭니다.
매개 변수
| value:Object — 최상위 XMLList() 함수를 사용하여 XMLList 객체로 변환할 수 있는 모든 객체입니다.
|
참고 사항
AS3 function attribute(attributeName:*):XMLList
| Player 버전 : | Flash Player 9 |
각 XML 객체의 attribute() 메서드를 호출하고 결과의 XMLList 객체를 반환합니다. 그 결과는 지정된 attributeName 매개 변수와 일치합니다. 일치하는 항목이 없으면 attribute() 메서드는 빈 XMLList 객체를 반환합니다.
매개 변수
| attributeName:* — XMLList 객체에 포함할 특성 이름입니다.
|
반환값
| XMLList — 일치하는 XML 객체의 XMLList 객체 또는 빈 XMLList 객체입니다.
|
참고 사항
AS3 function attributes():XMLList
| Player 버전 : | Flash Player 9 |
각 XML 객체의 attributes() 메서드를 호출하고 각 XML 객체에 대한 특성의 XMLList 객체를 반환합니다.
반환값
| XMLList — 각 XML 객체의 특성이 포함된 XMLList 객체입니다.
|
참고 사항
AS3 function child(propertyName:Object):XMLList
| Player 버전 : | Flash Player 9 |
각 XML 객체의 child() 메서드를 호출하고 결과가 순서대로 포함된 XMLList 객체를 반환합니다.
매개 변수
| propertyName:Object — XML 자식의 요소 이름 또는 정수입니다.
|
반환값
| XMLList — 입력 매개 변수와 일치하는 자식 노드의 XMLList 객체입니다.
|
참고 사항
AS3 function children():XMLList
| Player 버전 : | Flash Player 9 |
각 XML 객체의 children() 메서드를 호출하고 결과가 포함된 XMLList 객체를 반환합니다.
반환값
| XMLList — XML 객체의 자식이 포함된 XMLList 객체입니다.
|
참고 사항
AS3 function comments():XMLList
| Player 버전 : | Flash Player 9 |
각 XML 객체의 comments() 메서드를 호출하고 주석의 XMLList를 반환합니다.
반환값
| XMLList — XML 객체의 주석이 포함된 XMLList입니다.
|
참고 사항
AS3 function contains(value:XML):Boolean
| Player 버전 : | Flash Player 9 |
XMLList 객체에 지정된 value 매개 변수와 같은 XML 객체가 포함되어 있는지 확인합니다.
매개 변수
| value:XML — 현재 XMLList 객체와 비교할 XML 객체입니다.
|
반환값
| Boolean — value 매개 변수로 선언한 XML 객체가 XMLList에 포함되어 있으면 true이고, 그렇지 않으면 false입니다.
|
참고 사항
AS3 function copy():XMLList
| Player 버전 : | Flash Player 9 |
지정된 XMLList 객체의 복사본을 반환합니다. 이 복사본은 노드 트리 전체를 복제한 것입니다. 복사된 XML 객체에는 부모가 없으며 parent() 메서드를 호출하면 null이 반환됩니다.
반환값
참고 사항
AS3 function descendants(name:Object = *):XMLList
| Player 버전 : | Flash Player 9 |
지정된 name 매개 변수가 있는 XML 객체의 모든 자손(자식, 손자, 증손자 등)을 반환합니다. name 매개 변수는 QName 객체, String 데이터 유형 또는 나중에 String 데이터 유형으로 변환되는 기타 모든 데이터 유형이 될 수 있습니다.
모든 자손을 반환하려면 별표(*) 매개 변수를 사용합니다. 매개 변수를 전달하지 않으면 "*" 문자열이 전달되고 XML 객체의 모든 자손이 반환됩니다.
매개 변수
| name:Object (default = *) — 비교할 요소 이름입니다.
|
반환값
| XMLList — 원래 목록에 있는 XML 객체의 일치하는 자손(자식, 손자 등)이 포함된 XMLList 객체입니다. 자손이 없으면 빈 XMLList 객체가 반환됩니다.
|
참고 사항
AS3 function elements(name:Object = *):XMLList
| Player 버전 : | Flash Player 9 |
각 XML 객체의 elements() 메서드를 호출합니다. name 매개 변수가 descendants() 메서드에 전달됩니다. 매개 변수를 전달하지 않으면 "*" 문자열이 descendants() 메서드에 전달됩니다.
매개 변수
| name:Object (default = *) — 비교할 요소의 이름입니다.
|
반환값
| XMLList — XML 객체의 일치하는 자식 요소가 포함된 XMLList 객체입니다.
|
참고 사항
AS3 function hasComplexContent():Boolean
| Player 버전 : | Flash Player 9 |
XMLList 객체에 복잡한 내용이 들어 있는지 확인합니다. XMLList 객체가 비어 있지 않고 다음 조건 중 하나가 참이면 복잡한 내용이 들어 있는 것으로 간주됩니다.
- XMLList 객체에 복잡한 내용이 포함된 XML 항목 하나가 들어 있는 경우
- XMLList 객체에 요소가 포함된 경우
반환값
| Boolean — XMLList 객체에 복잡한 내용이 들어 있으면 true이고, 그렇지 않으면 false입니다.
|
참고 사항
AS3 function hasOwnProperty(p:String):Boolean
| Player 버전 : | Flash Player 9 |
p에 지정된 속성이 있는지 확인합니다.
매개 변수
반환값
| Boolean — 매개 변수가 있으면 true이고, 그렇지 않으면 false입니다.
|
참고 사항
AS3 function hasSimpleContent():Boolean
| Player 버전 : | Flash Player 9 |
XMLList 객체에 간단한 내용이 들어 있는지 확인합니다. 다음 조건 중 하나 이상이 참이면 XMLList 객체에 간단한 내용이 들어 있는 것으로 간주됩니다.
- XMLList 객체가 비어 있는 경우
- XMLList 객체에 간단한 내용이 포함된 XML 항목 하나가 들어 있는 경우
- XMLList 객체에 요소가 없는 경우
반환값
| Boolean — XMLList에 간단한 내용이 들어 있으면 true이고, 그렇지 않으면 false입니다.
|
참고 사항
AS3 function length():int
| Player 버전 : | Flash Player 9 |
XMLList 객체의 속성 수를 반환합니다.
반환값
| int — XMLList 객체의 속성 수입니다.
|
참고 사항
AS3 function normalize():XMLList
| Player 버전 : | Flash Player 9 |
인접한 텍스트 노드를 병합하고 XMLList의 모든 텍스트 노드, XMLList에 포함된 모든 XML 객체 및 XMLList에 포함된 모든 XML 객체의 자손에서 빈 텍스트 노드를 제거합니다.
반환값
참고 사항
AS3 function parent():Object
| Player 버전 : | Flash Player 9 |
XMLList 객체에 포함된 모든 항목의 부모가 동일한 경우 XMLList 객체의 부모를 반환합니다. XMLList 객체에 부모가 없거나 부모가 서로 다른 경우 이 메서드는 undefined를 반환합니다.
반환값
참고 사항
AS3 function processingInstructions(name:String = "*"):XMLList
| Player 버전 : | Flash Player 9 |
name 매개 변수를 제공한 경우 XMLList 객체에서 해당 이름의 처리 명령이 포함된 모든 자식을 나열합니다. 매개 변수를 제공하지 않으면 이 메서드는 XMLList 객체에서 처리 명령이 하나라도 포함된 자식을 모두 나열합니다.
매개 변수
| name:String (default = "*") — 비교할 처리 명령의 이름입니다.
|
반환값
| XMLList — 각 XML 객체의 처리 명령이 포함된 XMLList 객체입니다.
|
참고 사항
AS3 function propertyIsEnumerable(p:String):Boolean
| Player 버전 : | Flash Player 9 |
p 속성이 XMLList 객체에 적용되는 for..in 문에서 반복할 수 있는 속성 집합에 포함되는지 여부를 확인합니다. toNumber(p)가 0보다 크거나 같고 XMLList 객체의 길이보다 작은 경우에만 true입니다.
매개 변수
반환값
| Boolean — for..in 문에서 속성을 반복할 수 있으면 true이고, 그렇지 않으면 false입니다.
|
참고 사항
AS3 function text():XMLList
| Player 버전 : | Flash Player 9 |
각 XML 객체의 text() 메서드를 호출하고 결과가 포함된 XMLList 객체를 반환합니다.
반환값
| XMLList — XML 텍스트 노드를 나타내는 XMLList 객체의 모든 XML 속성이 포함된 XMLList 객체입니다.
|
참고 사항
AS3 function toString():String
| Player 버전 : | Flash Player 9 |
XMLList 객체에 포함된 모든 XML 객체를 표현한 문자열을 반환합니다. 이 변환의 규칙은 XML 객체의 내용이 간단한지 복잡한지에 따라 다릅니다.
- XML 객체의 내용이 간단하면
toString()은 시작 태그, 특성, 네임스페이스 선언 및 끝 태그를 제외한 XML 객체의 문자열 내용을 반환합니다.
- XML 객체의 내용이 복잡하면
toString()은 시작 태그, 특성, 네임스페이스 선언 및 끝 태그를 포함하여 XML 객체 전체를 나타내는 XML 인코딩 문자열을 반환합니다.
항상 XML 객체 전체를 반환하려면 toXMLString() 메서드를 사용합니다.
반환값
참고 사항
예제
다음 예제에서는 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>
AS3 function toXMLString():String
| Player 버전 : | Flash Player 9 |
XMLList 객체에 포함된 모든 XML 객체를 표현한 문자열을 반환합니다. toString() 메서드와 달리 toXMLString() 메서드는 XML 객체의 내용이 간단한지 복잡한지에 관계없이 항상 XML 객체의 시작 태그, 특성 및 끝 태그를 반환합니다. toString() 메서드는 XML 객체에 간단한 내용이 포함되어 있는 경우 이러한 항목을 제거합니다.
반환값
참고 사항
AS3 function valueOf():XMLList
| Player 버전 : | Flash Player 9 |
XMLList 객체를 반환합니다.
반환값
참고 사항
다음 예제에서는
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());
}
}
}
}
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Tue Oct 16 2007, 12:25 AM GMT-07:00
현재 페이지: http://livedocs.adobe.com/flash/9.0_kr/ActionScriptLangRefV3/XMLList.html