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

# xml_set_character_data_handler

(PHP 4, PHP 5, PHP 7)

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

### 説明

xml_set_character_data_handler ( resource `$parser` , callable `$handler` ) : bool

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

### パラメータ

`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` を返します。