xml_set_character_data_handler
(PHP 4, PHP 5, PHP 7)
xml_set_character_data_handler — 文字データハンドラを設定する
説明
bool xml_set_character_data_handler
(
resource $parser
,
callable $handler
)
パラメータ
-
parser
-
文字データハンドラ関数を設定する XML パーサへの参照。
-
handler
-
handler
は、parser
に関して
xml_parse() がコールされた際に必要な関数の名前を有する文字列です。
handler
という名前の関数は、次の 2 つのパラメータをとります。
handler
( resource $parser
, string $data
)
-
parser
-
最初のパラメータである parser は、
ハンドラをコールする XML パーサへのリファレンスです。
-
data
-
2番目のパラメータである
data
は、
文字データを文字列として有しています。
文字データハンドラは、XML ドキュメントのすべてのテキストに対してコールされます。
(たとえば非 ASCII 文字列などで) ひとつのフラグメント内で複数回コールされることもあります。
ハンドラ関数が空の文字列または、
FALSE
に設定されている場合、そのハンドラは無効です。
注意: 関数名の代わりに、オブジェクトへの
リファレンスを格納した配列とメソッド名を指定することもできます。
返り値
成功した場合に TRUE
を、失敗した場合に FALSE
を返します。