XML パーサ 関数
PHP Manual

xml_set_notation_decl_handler

(PHP 4, PHP 5)

xml_set_notation_decl_handler表記法宣言ハンドラを設定する

説明

bool xml_set_notation_decl_handler ( resource $parser , callback $handler )

XML パーサ parser の表記法宣言用ハンドラ関数を設定します。

表記法の宣言は、ドキュメントの DTD の一部であり、 次のようなフォーマットとなります。

<!NOTATION <parameter>name</parameter>
{ <parameter>systemId</parameter> | <parameter>publicId</parameter>?>
表記法宣言の定義に関しては、 » XML 1.0 仕様の 4.7 節 を参照ください。

パラメータ

parser

表記法宣言ハンドラ関数を設定する XML パーサへの参照。

handler

handler は、 parser に関して xml_parse() がコールされた際に必要な関数の名前を有する文字列です。

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

handler ( resource $parser , string $notation_name , string $base , string $system_id , string $public_id )
parser
最初のパラメータ、parser は ハンドラをコールする XML パーサへのリファレンスです。
notation_name
これは、前記の表記用フォーマットに示すように表記法の 名前 です。
base
外部エンティティのシステムID(systemId)を 取得する際の基本となります。現在、このパラメータは、常に空の 文字列に設定されています。
system_id
外部表記用宣言のシステム ID
public_id
外部表記用宣言のパブリック ID

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

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

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。


XML パーサ 関数
PHP Manual