ISXML  
説明

文字列がウェルフォームドの XML テキストであるかどうかを調べます。

 
戻り値

関数パラメータがウェルフォームドの XML テキストを含む文字列である場合は true、そうでない場合は false。

 
カテゴリ

決定関数、XML 関数

 
関数のシンタックス
IsXML(value)
 
関連項目

IsXmlAttribute、IsXmlDoc、IsXmlElem、IsXmlNode、IsXmlRoot、XmlParse、XmlValidate、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」

 
ヒストリ

ColdFusion MX 7: この関数が追加されました。

 
パラメータ

 
使用方法

この関数は、テキストがウェルフォームド XML であるかどうか、つまりすべての XML シンタックスおよび構築ルールに準拠しているかどうかを調べます。文字列は完全な XML ドキュメントでなくてもかまいません。この関数は、DTD (ドキュメントタイプ定義) または XML スキーマについては照合しません。

 

次の例では、2 つの文字列を作成し、それらがウェルフォームドの XML テキストであるかどうかをテストします。

<!--- ウェルフォームドの XML 文字列 --->
<cfset xmlString1='<order id="4323251">
   <customer firstname="Philip" lastname="Cramer" accountNum="21"/>
   <items>
      <item id="43">
         <quantity>1</quantity>
         <unitprice>15.95</unitprice>
      </item>
   </items>
</order>'
>

<!--- 終了タグ </item> がない、無効な XML 文字列 --->
<cfset xmlString2='<order id="4323251">
   <customer firstname="Philip" lastname="Cramer" accountNum="21"/>
   <items>
      <item id="43">
         <quantity>1</quantity>
         <unitprice>15.95</unitprice>
   </items>
</order>'
>

<!--- 文字列をテストしてウェルフォームドの XML であるかどうかを確認する --->
<cfoutput>
xmlString1 に含まれているテキスト :<br><br>
#HTMLCodeFormat(xmlstring1)#
ウェルフォームドの XML テキストですか?#IsXML(xmlString1)#<br><br>
<hr>
xmlString2 に含まれているテキスト :<br><br>
#HTMLCodeFormat(xmlstring2)#
ウェルフォームドの XML テキストですか?#IsXML(xmlString2)#
</cfoutput>
VALUE  
XML ドキュメントテキストを含む文字列です。