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>

См. в Разделе 4.2.2 спецификации XML 1.0 определение нотации объявлений внешних экземпляров.

Функция 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 не является разборщиком.

Примечание: вместо имени функции может быть предоставлен также массив, содержащий ссылку на объект и имя метода.