xml_set_character_data_handler

文字データハンドラを設定する

説明

true xml_set_character_data_handler(XMLParser $parser, callable $handler)

XML パーサ parser の文字データ用ハンドラ関数を設定します。

パラメータ

parser

XMLパーサ

handler

null や空文字列を渡すと、ハンドラはデフォルトの状態にリセットされます。

handlercallable の場合、その callable がハンドラとして設定されます。

handler が文字列の場合、xml_set_object で設定されたオブジェクトのメソッド名になります。

handler のシグネチャは、以下でなければいけません:

void handler(XMLParser $parser, string $data)
parser
ハンドラをコールするXMLパーサ
data
文字データを文字列として指定します。

文字データハンドラは、XML ドキュメントのすべてのテキストに対してコールされます。 (たとえば非 ASCII 文字列などで) ひとつのフラグメント内で複数回コールされることもあります。

戻り値

常に true を返します。

変更履歴

バージョン 説明
8.0.0 引数 parser は、 XMLParser インスタンスを期待するようになりました。 これより前のバージョンでは、有効な xml resource が期待されていました。