関数・クラス解説

xml_set_element_handler

version:PHP 4, PHP 5, PHP 7 (公式)

開始要素および終了要素のハンドラを設定する

xml_set_element_handler ( resource $parser , callable $start_element_handler , callable $end_element_handler ) : bool

start_element_handler ( resource $parser , string $name , array $attribs )

end_element_handler ( resource $parser , string $name )

XML パーサ parser の要素ハンドラ関数を設定します。 start_element_handler および end_element_handler は、 xml_parse() が parser をコールした際に存在している必要がある関数の名前を有する文字列です。

parser

開始要素および終了要素のハンドラ関数を設定する XML パーサへの参照。

start_element_handler

start_element_handler という名前の関数は、次の 3 つのパラメータをとる必要があります。

parser: 最初のパラメータである parser は、ハンドラをコールする XML パーサへのリファレンスです。
name: 2 番目のパラメータである name は、このハンドラがコールされた要素の名前を有しています。大文字変換がこのパーサに関して有効な場合、要素の名前は大文字になります。
attribs: 第 3 のパラメータである attribs は、その要素の (全)属性に関する連想配列です。この配列のキーは属性の名前であり、値は属性の値です。属性の名前は、要素名と同様に大文字変換となります。属性の値は、大文字変換されません。この属性は、each() を使用して attribs を順次アクセスすることにより、元の順序で取得することができます。配列の最初のキーが最初の属性であり、後も同様です。

注意: 関数名の代わりに、オブジェクトへのリファレンスを格納した配列とメソッド名を指定することもできます。

end_element_handler

end_element_handlerという名前の関数は、 2 つのパラメータをとる必要があります。

parser: 最初のパラメータである parser は、ハンドラをコールする XML パーサへのリファレンスです。
name: 2 番目のパラメータである name は、このハンドラがコールされた要素の名前を有しています。このパーサにおいて大文字変換が有効な場合、要素名は大文字になります。

ハンドラ関数が空の文字列または FALSE に設定されている場合、そのハンドラは無効です。