xml_set_character_data_handler

(PHP 4, PHP 5, PHP 7)

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

Описание

xml_set_character_data_handler ( XMLParser $parser , callable $handler ) : bool

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

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

parser

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

handler

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

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

handler ( XmlParser $parser , string $data )
parser
Первый аргумент parser является ссылкой на XML-анализатор вызывающий обработчик.
data
Второй аргумент data должен содержать данные в виде текстовой строки.

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

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

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

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

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

Список изменений

Версия Описание
8.0.0 Параметр parser ожидает экземпляр XMLParser; ранее ожидался ресурс (resource).