Описание функции xml-set-unparsed-entity-decl-handler
xml_set_unparsed_entity_decl_handler
(PHP 3>= 3.0.6, PHP 4)
xml_set_unparsed_entity_decl_handler - настраивает обработчик объявления неразобранного экземпляра/unparsed entity.
Описание
bool xml_set_unparsed_entity_decl_handler (resource parser, string handler)
Устанавливает функцию обработчика объявления неразобранного экземпляра для XML-разборщика parser .
handler это строка с именем функции, которая обязана существовать в момент вызова xml_parse() для parser .
Этот обработчик будет вызываться, если XML-разборщик обнаружит объявление внешнего экземпляра с объявлением NDATA, как здесь:
<!ENTITY
name
{
publicId
|
systemId
}
NDATA
notationName
>
|
См. в определение нотации объявлений внешних экземпляров.
Функция handler обязана принимать 6 параметров: handler (resource parser, string entity_name, string base, string system_id, string public_id, string notation_name)
- parser
-
Это ссылка на XML-разборщик, вызывающий обработчик. - entity_name
-
Имя определяемого внешнего экземпляра. - base
-
Это база для разрешения системного идентификатора ( system_id ) объявления нотации. В настоящее время в этот параметр всегда устанавливается пустая строка. - system_id
-
Системный идентификатор для внешнего экземпляра. - public_id
-
Public-идентификатор для внешнего экземпляра. - notation_name
-
Имя нотации данного экземпляра (см. xml_set_notation_decl_handler() ).
Если функция обработчика установлена как пустая строка, или FALSE , обработчик отключается/disabled.
TRUE возвращается, если обработчик настроен, а FALSE , если parser не является разборщиком.
Примечание: вместо имени функции может быть предоставлен также массив, содержащий ссылку на объект и имя метода.
