XMLSEARCH | |
説明
XPath 言語式を使用して XML ドキュメントオブジェクトを検索します。 |
|
戻り値
検索条件に一致する XML オブジェクトノードの配列 |
|
カテゴリ
XML 関数 |
|
関数のシンタックスXmlSearch(xmlDoc, xPathString) |
|
関連項目
cfxml、IsXML、XmlChildPos、XmlParse、XmlTransform、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」 |
|
ヒストリ
ColdFusion MX 7: 属性の検索に対するサポートが追加されました。 ColdFusion MX: この関数が追加されました。 |
|
パラメータ
|
|
使用方法
XmlSearch 関数は、XPath シンタックスを完全にサポートするわけではありません。サポートするのは、1 つ以上の XML ノードを返す XPath 式および属性の検索だけです。文字列、数値、ブール値など、その他のタイプの値を返す XPath 式では、エラーが生成されます。 XPath は W3C (World Wide Web Consortium) によって仕様が定められています。XPath 式シンタックスなどの XPath の詳細については、W3C の Web サイト www.w3.org/TR/xpath を参照してください。 |
|
例
次の例では、従業員の姓が格納されている last という名前の要素を XML ファイルから抽出し、姓を表示します。 "employeesimple.xml" ファイルには次の XML が格納されています。 <?xml version="1.0" encoding="UTF-8"?> <employee> <!-- 従業員のリスト --> <name EmpType="Regular"> <first>Almanzo</first> <last>Wilder</last> </name> <name EmpType="Contract"> <first>Laura</first> <last>Ingalls</last> </name> </employee> この CFML ファイルには次の行が含まれています。 <cfscript> myxmldoc = XmlParse("C:CFusionMX7wwwrootexamplesemployeesimple.xml"); selectedElements = XmlSearch(myxmldoc, "/employee/name/last"); for (i = 1; i LTE ArrayLen(selectedElements); i = i + 1) writeoutput(selectedElements[i].XmlText & "<br>"); </cfscript> |
XMLDOC | |
XML ドキュメントオブジェクトです。 |
XPATHSTRING | |
XPath 式です。 |