<?xml version="1.0" encoding="utf-8"?>

<chapter xml:id="simplexml.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

&reftitle.examples;

<section xml:id="simplexml.examples-basic">

<title>基本的な SimpleXML の使用法</title>

<para>

このリファレンスの多くの例では XML 文字列が必要です。それぞれの例で

この文字列をくり返す代わりに、あるファイルにこの文字列を保存して、

例ごとに読みこむことにします。この読みこまれるファイルは、以下の例

に関するセクションで使います。

もしくは、XMLドキュメントを作成し、

<function>simplexml_load_file</function> により読みこむことも

可能です。

</para>

<para>

<example>

<title>XML 文字列を設定するインクルードファイル examples/simplexml-data.php</title>

<programlisting role="php" xml:id="simplexml.examples.movie">

</programlisting>

</example>

</para>

<para>

SimpleXML の容易さが最も明確に現われるのは、

簡単な XML ドキュメントから文字列または数字を展開する時です。

<example>

<title>Getting <literal>&lt;plot&gt;</literal></title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

XML ドキュメント内の要素のうち、PHP の命名規約で許可されていない文字

(たとえばハイフンなど) を含む名前のものにアクセスするには、

要素名を括弧とアポストロフィで囲みます。

<example>

<title><literal>&lt;line&gt;</literal> を取得する</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>SimpleXML でユニークでない要素にアクセスする</title>

<simpara>

単一の親要素の子要素としてある要素のインスタンスが複数存在する時、

通常の反復処理を適用することができます。

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<note>

<para>

プロパティ (先ほどの例の <literal>$movies->movie</literal>)

は配列ではありません。<link linkend="class.iterator">反復処理</link> と

<link linkend="class.arrayaccess">配列形式でのアクセス</link> ができるオブジェクトです。

</para>

</note>

<para>

<example>

<title>属性を使用する</title>

<simpara>

ここまでは、要素の名前と値を読む方法のみを扱って来ました。

SimpleXML は要素の属性にアクセスすることも可能です。

要素の属性にアクセスする方法は、<type>array</type> の要素に

アクセスするのと全く同じです。

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>要素および属性をテキストと比較する</title>

<simpara>

要素または属性を文字列と比較する、もしくは、文字列を引数とする関数に

渡すには、<literal>(string)</literal> により文字列にキャストする

必要があります。さもないと、PHP はこの要素をオブジェクトとして扱います。

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>ふたつの要素の比較</title>

<simpara>

たとえ同一の要素を指していたとしても

2 つの SimpleXMLElements は異なるものと見なされます。

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>XPath の使用</title>

<simpara>

SimpleXML は、<acronym>XPath</acronym> を標準でサポートしています。

<literal>&lt;character&gt;</literal> 要素をすべて見つけるには、

以下のようにします。

</simpara>

<simpara>

'<literal>//</literal>' は、ワイルドカードとして機能します。

完全なパスを指定するには、スラッシュをひとつ省略します:

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>値を設定する</title>

<simpara>

SimpleXMLの中のデータは、定数とすることができません。

オブジェクトは、その全ての要素について変更が可能です。

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>要素と属性を追加する</title>

<simpara>

SimpleXML を使用して簡単に子要素および属性を追加することができます。

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>DOM との相互運用性</title>

<simpara>

PHP は、SimpleXML 形式と DOM 形式の間で XML ノードを変換する機構を有しています。

この例では、DOM 要素を SimpleXML に変換することができます。

</simpara>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>名前空間を扱う</title>

<programlisting role="php">

</programlisting>

</example>

</para>

</section>

<section xml:id="simplexml.examples-errors">

<title>XML エラーの対応</title>

<para>

ドキュメント読み込み時の XML エラーに対処するのは非常にシンプルな作業です。

<link linkend="book.libxml">libxml</link> の機能を使うと、

ドキュメント読み込み時のすべての XML エラーを抑制して後からそれを処理することができます。

</para>

<para>

<function>libxml_get_errors</function> が返す

<classname>LibXMLError</classname> オブジェクトには、エラーについての

<link linkend="libxmlerror.props.message">message</link> や

<link linkend="libxmlerror.props.line">line</link>、

<link linkend="libxmlerror.props.column">column</link> (場所)

といったプロパティが含まれます。

</para>

<para>

<example>

<title>壊れた XML 文字列の読み込み</title>

<programlisting role="php" xml:id="simplexml.examples.error">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<section role="seealso"><!-- {{{ -->

&reftitle.seealso;

<para>

<simplelist>

<member><function>libxml_use_internal_errors</function></member>

<member><function>libxml_get_errors</function></member>

<member><xref linkend="class.libxmlerror" /></member>

</simplelist>

</para>

</section>

</section>

</chapter>