xml_set_unparsed_entity_decl_handler - Установка обработчика неразобранных объявлений сущностей
Вернуться к: Функции парсера XML
xml_set_unparsed_entity_decl_handler
(PHP 4, PHP 5)
xml_set_unparsed_entity_decl_handler — Установка обработчика неразобранных объявлений сущностей
Описание
Задает функцию обработчик неразобранных объявлений сущностей для XML анализатора parser.
Обработчик handler будет вызван, если XML анализатор обнаружит NDATA объявление внешней сущности вида:
<!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>}
NDATA <parameter>notationName</parameter>
См. » раздел 4.2.2 XML 1.0 спецификации, чтобы получить точное определение обозначений внешних сущностей.
Список параметров
- parser
-
Ссылка на XML анализатор для которого задается обработчик.
- handler
-
handler - строка содержащая имя функции, которая должна быть определена на момент вызова функции xml_parse() из анализатора parser.
Функция с именем handler должна принимать шесть аргументов:
handler ( resource $parser , string $entity_name , string $base , string $system_id , string $public_id , string $notation_name )- parser
- Первый аргумент parser является ссылкой на XML анализатор вызывающий обработчик.
- entity_name
- Имя сущности, которой требуется дать определение.
- base
- Это основа для разрешения системного идентификатора (system_id) внешней сущности. На данный момент в качестве этого аргумента всегда передается пустая строка.
- system_id
- Системный идентификатор внешней сущности.
- public_id
- Общедоступный идентификатор внешней сущности.
- notation_name
- Имя обозначения этой сущности (см. xml_set_notation_decl_handler()).
Если в качестве обработчика передана пустая строка или FALSE, этот обработчик отключается.
Замечание: В качестве аргумента вместо имени функции может быть передан массив, содержащий ссылку на объект и имя метода.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Вернуться к: Функции парсера XML