xml_set_element_handler
(PHP 4, PHP 5)
xml_set_element_handler —
Установка обработчика начального и конечного элементов
Описание
bool xml_set_element_handler
(
resource $parser
,
callback $start_element_handler
,
callback $end_element_handler
)
Список параметров
-
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 в случае возникновения ошибки.