xml_set_element_handler
(PHP 4, PHP 5, PHP 7)
xml_set_element_handler — Установка обработчика начального и конечного элементов
Описание
$parser
, callable $start_handler
, callable $end_handler
) : bool
Устанавливает функцию обработчик элементов для XML-анализатора
parser
. start_handler
и end_handler
- строки, содержащие имена
функций, которые должны быть определены на момент вызова функции
xml_parse() из анализатора parser
.
Список параметров
-
parser
-
Ссылка на XML-анализатор.
-
start_handler
-
Функция с именем
start_handler
должна принимать три аргумента:-
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).
|