(PHP 4, PHP 5, PHP 7)
xml_set_element_handler — Установка обработчика начального и конечного элементов
$parser
, callable $start_element_handler
, callable $end_element_handler
)
Устанавливает функцию обработчик элементов для XML анализатора
parser
. start_element_handler
и end_element_handler
- строки, содержащие имена
функций, которые должны быть определены на момент вызова функции
xml_parse() из анализатора parser
.
parser
Ссылка на XML анализатор.
start_element_handler
Функция с именем start_element_handler
должна принимать три аргумента:
$parser
, string $name
, array $attribs
)parser
name
name
содержит имя элемента,
для которого этот обработчик вызывается. Если настройка case-folding включена для этого
анализатора, имя элемента будет в верхнем регистре.
attribs
attribs
содержит
ассоциативный массив с атрибутами элемента (если есть). Индексами
этого массива будут имена атрибутов, а значения массива будут
соответствовать значениям атрибутов. Имена атрибутов должны быть
приведены к регистру в
соответствии с теми же критериями, что и имена элементов. Значения
атрибутов не приводятся к какому-либо регистру.
Атрибуты извлекаются из элемента в порядке прямого обхода
по attribs
, используя функцию
each().Первый индекс в массиве соответствует
первому атрибуту и так далее.
Замечание: В качестве аргумента вместо имени функции может быть передан массив, содержащий ссылку на объект и имя метода.
end_element_handler
Функция с именем end_element_handler
должна принимать два аргумента:
$parser
, string $name
)parser
name
name
содержит имя элемента,
для которого этот обработчик вызывается. Если настройка case-folding включена для этого
анализатора, имя элемента будет в верхнем регистре.
Если в качестве обработчика передана пустая строка или FALSE
, этот
обработчик отключается.
Возвращает TRUE
в случае успешного завершения или FALSE
в случае возникновения ошибки.