| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
XMLList クラスには、XML エレメントを操作するためのメソッドが含まれています。XMLList オブジェクトは複数の XML オブジェクトまたはエレメント（複数のノードまたは属性を含む）を表すこともできるので、コレクション内のエレメント全体に対してメソッドを呼び出すことも、コレクション内のエレメントごとにメソッドを呼び出すことも可能です。
XMLList オブジェクトに XML エレメントが 1 つしかない場合は、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)| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
新しい XMLList オブジェクトを作成します。
パラメータ | value:Object —
トップレベル関数 XMLList() によって XMLList オブジェクトに変換可能なオブジェクトです。
|
関連項目
AS3 function attribute(attributeName:*):XMLList| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
各 XML オブジェクトの attribute() メソッドを呼び出し、その結果の XMLList オブジェクトを返します。この結果は、指定された attributeName パラメータに一致します。一致する XML オブジェクトがなかった場合、attribute() メソッドは空の XMLList オブジェクトを返します。
パラメータ
| attributeName:* — XMLList オブジェクト内に含める属性の名前です。 |
戻り値 | XMLList — XML オブジェクトが一致する XMLList オブジェクト、または空の XMLList オブジェクトです。 |
関連項目
AS3 function attributes():XMLList| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
各 XML オブジェクトの attributes() メソッドを呼び出し、各 XML オブジェクトの属性の XMLList オブジェクトを返します。
戻り値 | XMLList — 各 XML オブジェクトの属性の XMLList オブジェクトです。 |
関連項目
AS3 function child(propertyName:Object):XMLList| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
各 XML オブジェクトの child() メソッドを呼び出し、その結果を順に含む XMLList オブジェクトを返します。
パラメータ
| propertyName:Object — XML の子のエレメント名または整数です。 |
戻り値 | XMLList — 入力パラメータに一致する子ノードの XMLList オブジェクトです。 |
関連項目
AS3 function children():XMLList| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
各 XML オブジェクトの children() メソッドを呼び出し、その結果を含む XMLList オブジェクトを返します。
戻り値 | XMLList — XML オブジェクト内の子（複数）の XMLList オブジェクトです。 |
関連項目
AS3 function comments():XMLList| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
各 XML オブジェクトの comments() メソッドを呼び出し、コメントの XMLList を返します。
戻り値 | XMLList — XML オブジェクト内のコメントの XMLList です。 |
関連項目
AS3 function contains(value:XML):Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
指定された value パラメータに等しい XML オブジェクトが XMLList オブジェクトに含まれるかどうかを確認します。
パラメータ
| value:XML — 現在の XMLList オブジェクトと比較する XML オブジェクトです。 |
戻り値 | Boolean —
value パラメータで宣言された XML オブジェクトが XMLList オブジェクトに含まれる場合は true、それ以外の場合は false を返します。
|
関連項目
AS3 function copy():XMLList| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
指定された XMLList オブジェクトのコピーを返します。コピーとはノードのツリー全体の複製です。コピーされた XML オブジェクトに親はないので、null が返されます（parent() メソッドを呼び出した場合）。
戻り値関連項目
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 オブジェクトを返します。 |
関連項目
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 オブジェクトです。 |
関連項目
AS3 function hasComplexContent():Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
XMLList オブジェクトに複合内容が含まれるかどうかを確認します。XMLList オブジェクトが空でなく、次のいずれかの条件が true の場合に、XMLList オブジェクトは複合内容を持つと見なされます。
- XMLList オブジェクトに、複合内容を持つ 1 つの XML アイテムが含まれている。
- XMLList オブジェクトに複数のエレメントが含まれている。
戻り値 | Boolean —
XMLList オブジェクトに複合内容が含まれる場合は true、それ以外の場合は false を返します。
|
関連項目
AS3 function hasOwnProperty(p:String):Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
p により指定されたプロパティをチェックします。
パラメータ
戻り値 | Boolean —
パラメータが存在する場合は true、それ以外の場合は false を返します。
|
関連項目
AS3 function hasSimpleContent():Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
XMLList オブジェクトに単純内容が含まれるかどうかを確認します。次のいずれかの条件が true の場合に、XMLList オブジェクトは単純内容を持つと見なされます。
- XMLList オブジェクトが空である。
- XMLList オブジェクトに、単純内容を持つ 1 つの XML アイテムが含まれている。
- XMLList オブジェクトにエレメントが含まれていない。
戻り値 | Boolean —
XMLList に単純内容が含まれる場合は true、それ以外の場合は false を返します。
|
関連項目
AS3 function length():int| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
XMLList オブジェクト内のプロパティ数を返します。
戻り値 | int — XMLList オブジェクト内のプロパティ数です。 |
関連項目
AS3 function normalize():XMLList| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
隣接するテキストノードを結合し、XMLList 内のすべてのテキストノード、XMLList に含まれるすべての XML オブジェクト、および XMLList 内のすべての XML オブジェクトの子孫について、それぞれ空のテキストノードを削除します。
戻り値関連項目
AS3 function parent():Object| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
XMLList オブジェクト内のすべてのアイテムが同じ親を持つ場合、XMLList オブジェクトの親を返します。XMLList オブジェクトが親を持たないか、異なる親を持つ場合、メソッドは undefined を返します。
戻り値関連項目
AS3 function processingInstructions(name:String = "*"):XMLList| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
name パラメータを指定した場合、その名前を持つ処理命令を含む XMLList オブジェクトのすべての子を一覧表示します。パラメータを指定しなかった場合、メソッドは任意の処理命令を含む XMLList オブジェクトのすべての子を一覧表示します。
パラメータ
| name:String (default = "*") |
戻り値 | XMLList — 各 XML オブジェクトの処理命令を含む XMLList オブジェクトです。 |
関連項目
AS3 function propertyIsEnumerable(p:String):Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
プロパティ p が、XMLList オブジェクトに適用される for..in ステートメント内で反復処理されるプロパティセット内にあるかどうかを確認します。true が返るのは、toNumber(p) が 0 より大きいか等しく、かつ XMLList オブジェクトの長さより小さい場合のみです。
パラメータ
| p:String — 確認するプロパティのインデックスです。 |
戻り値 | Boolean —
for..in ステートメント内でプロパティを反復処理できる場合は true、それ以外の場合は false を返します。
|
関連項目
AS3 function text():XMLList| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
各 XML オブジェクトの text() メソッドを呼び出し、その結果を含む XMLList オブジェクトを返します。
戻り値 | XMLList — XML テキストノードを表す XMLList オブジェクトのすべての XML プロパティの XMLList オブジェクトです。 |
関連項目
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> AS3 function toXMLString():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
XMLList オブジェクト内のすべての XML オブジェクトのストリング表現を返します。toString() メソッドとは異なり、toXMLString() メソッドは、XML オブジェクトに単純内容が含まれるか、複合内容が含まれるかに関係なく、常に XML オブジェクトの開始タグ、属性、および終了タグを返します。toString() メソッドは、単純内容を持つ XML オブジェクトの開始タグ、属性、および終了タグを削除します。
戻り値 | String — XML オブジェクトのストリング表現です。 |
関連項目
AS3 function valueOf():XMLList| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
XMLList オブジェクトを返します。
戻り値関連項目
次の例は
books という名前の XML プロパティを作成し、
book publisher タグや
name タグを持ついくつかのアイテムを
books というノードに追加しています。 次に
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-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 12:14 AM -08:00 
Object
継承されるパブリックプロパティを隠す
継承されるパブリックプロパティを表示