xml_set_element_handler

(PHP 4, PHP 5, PHP 7)

xml_set_element_handlerУстановка обработчика начального и конечного элементов

Описание

xml_set_element_handler ( XMLParser $parser , callable $start_handler , callable $end_handler ) : bool

Устанавливает функцию обработчик элементов для XML-анализатора parser. start_handler и end_handler - строки, содержащие имена функций, которые должны быть определены на момент вызова функции xml_parse() из анализатора parser.

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

parser

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

start_handler

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

start_handler ( XMLParser $parser , string $name , array $attribs )
parser
Первый аргумент parser является ссылкой на XML-анализатор вызывающий обработчик.
name
Второй аргумент name содержит имя элемента, для которого этот обработчик вызывается. Если настройка case-folding включена для этого анализатора, имя элемента будет в верхнем регистре.
attribs
Третий аргумент attribs содержит ассоциативный массив с атрибутами элемента (если есть). Индексами этого массива будут имена атрибутов, а значения массива будут соответствовать значениям атрибутов. Имена атрибутов должны быть приведены к регистру в соответствии с теми же критериями, что и имена элементов. Значения атрибутов не приводятся к какому-либо регистру. Атрибуты извлекаются из элемента в порядке прямого обхода по attribs, используя функцию each(). Первый индекс в массиве соответствует первому атрибуту и так далее.

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

end_element

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

end_element ( resource $parser , string $name )
parser
Первый аргумент parser является ссылкой на XML-анализатор вызывающий обработчик.
name
Второй аргумент name содержит имя элемента, для которого этот обработчик вызывается. Если настройка case-folding включена для этого анализатора, имя элемента будет в верхнем регистре.

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

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

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

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

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