Установка обработчика символьных данных

Описание

bool xml_set_character_data_handler ( resource $parser , callable $handler )

Устанавливает обработчик символьных данных для заданного XML анализатора parser.

Список параметров

parser

Ссылка на XML анализатор.

handler

handler - строка содержащая имя функции, которая должна быть определена на момент вызова функции xml_parse() из анализатора parser.

Функция с именем handler должна принимать два аргумента:

handler ( resource $parser , string $data )

parser: Первый аргумент parser является ссылкой на XML анализатор вызывающий обработчик.
data: Второй аргумент data должен содержать данные в виде текстовой строки.

Обработчик символьных данных вызывается для каждого фрагмента текста в XML документе. Он также может вызываться несколько раз внутри каждого фрагмента (например для не-ASCII строк).

Если в качестве обработчика передана пустая строка или FALSE, этот обработчик отключается.

Замечание: В качестве аргумента вместо имени функции может быть передан массив, содержащий ссылку на объект и имя метода.

Возвращаемые значения

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.