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