xml_set_character_data_handler

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

parser

XML-парсер.

handler

При передаче значения null обработчик возвращается в состояние по умолчанию.

Внимание

Пустая строка тоже сбросит обработчик, однако начиная с PHP 8.4.0 передача в параметр пустой строки устарела.

Функция установит как обработчик функцию, на которую указывает callable-выражение, если в параметр handler передали значение, которое вызывается как функция.

Параметр handler принимает строку (string) с названием метода объекта, который установили функцией xml_set_object().

Внимание

Начиная с PHP 8.4.0 передача в параметр строки с названием метода устарела.

Внимание

Начиная с PHP 8.4.0 корректность callable-выражения проверяется при установке, а не при вызове обработчика. Поэтому вызвать функцию xml_set_object() потребуется до установки строки с названием метода, который вызывается как callback-функция. Однако, поскольку такое поведение тоже устарело с PHP 8.4.0, вместо передачи строки с названием метода рекомендуют указывать метод в правильном callable-выражении.

Сигнатура обработчика должна быть:

handler(XmlParser $parser, string $data): void

parser

XML-парсер, которым вызывается обработчик.

data

Данные в виде текстовой строки.

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