read_xml/2/3

テキスト・ストリームからXML項を読みます。

read_xml(+Stream？XmlTerm）
read_xml(+Stream, ?XmlTerm, +Options)

read_xml/2/3は、テキスト・ストリームStreamからXML項を読みます。 read_xml(Stream, Term)は、read_xml(Stream, Term, [ignore_whitespace(true), ignore_comments(true), ignore_processing_instructions(true)])に等価です。

XML項が読まれるときに、以下のMINERVA項が生成されます。：
document(Header,RootElement,Misc)、HeaderはXMLファイルのPrologを記述している項のリストで、RootElementはXML項を表現します、そして、MiscはXMLファイルのエピローグを表現している項のリストです。 Prologは、XMLの宣言、その後のコメント、空白あるいは処理のコマンドからなります。 エピローグはコメント、処理指示、空白の列より成ります。
XML 宣言 (<?xml ...? > )は、MINERVA項xml([Attribute=Value, ...])に変換されます。
空白の列は、MINERVA項whitespace(Whitespaces)に変換されます。 オプションignore_whitespaceが偽へセットされるならば、空白項が生成されるだけです。
XMLコメント(<! -- ... -->)は、MINERVA項comment(CommentText)に変換されます。 オプションignore_commentsが偽にセットされるならば、コメント項が生成されるだけです。。
処理している命令(<?name .. ?>)は、MINERVA項pi(Name, PIContent)に変換されます。 オプションignore_processing_instructionsが偽へセットされるならば、処理命令項が生成されるだけです。
キャラクターデータまたはCDATA項から成っている要素ボディは、MINERVA項chardata(Text)に変換されます。
XML要素は、MINERVA項element(ElementName, Attributes, SubElements)に、変換されます。ここで、ElementNameは要素の名（マークアップ）で、そして、Attributesは要素（書式AttributeName = AttributeValue）の属性を表現しているリストです、そして、SubElementsは要素の全てのサブエレメントを表現しているリストです。 Whitespaces、Attribute、Value、Text、CommentText、Name、PIContent、AttributeNameとAttributeValueは、アトムです。

Options-listの要素は以下でありえます：

ignore_whitespace(+Boolean)
ignore_comments(+Boolean)
ignore_processing_instructions(+Boolean)
Booleanは真または偽です。

引き数

Stream              テキスト入力ストリーム
XmlTerm             XML項を表現する項
Options             オプションリスト

例題

open(' hello', read, Stream, [atom,text]),
read_xml(Stream, Term).

->

Term = document([xml([version = '1.0'])],
    element(n1, [a1 = 'x', a2 = 'y'], [
       element(n2, [], [chardata('hello')]),
       element(n3, [a3 = 'z'], [])]), []).

標準

これらの述語は、ISO-Prolog Standardの要件ではありません。

以下も参照して下さい