(PHP 3 >= 3.0.6, PHP 4, PHP 5)
xml_set_unparsed_entity_decl_handler --
Affecte les gestionnaires d'entités non déclarées
Description
bool
xml_set_unparsed_entity_decl_handler ( resource parser, callback handler )
xml_set_unparsed_entity_decl_handler()
affecte les gestionnaires d'entités non déclarées de
l'analyseur XML parser. handler
est une chaîne qui contient le nom d'une fonction qui existe lorsque
xml_parse() est appelé pour créer
parser.
Ce gestionnaire sera appelé si l'analyseur XML rencontre une
déclaration d'entité externe avec une déclaration
de NDATA, comme suit :
<!ENTITY <parameter>name</parameter> {<parameter>publicid</parameter> | <parameter>systemid</parameter>}
NDATA <parameter>notationname</parameter> |
Reportez-vous à la section
des spécifications XML 1.0
pour connaître les notations des entités externes.
La fonction handler doit accepter six paramètres:
handler ( resource parser, string entity_name, string base, string system_id, string public_id, string notation_name )
- parser
Le premier paramètre, parser, est une
référence sur l'analyseur XML qui appelle cette fonction.
- entity_name
Le nom de l'entité qui va être définie
- base
La meilleure base de résolution de l'identifiant système
de cette entité externe. Actuellement, ce paramètre est
toujours une chaîne vide.
- system_id
Identifiant système pour cette entité externe.
- public_id
Identifiant public pour cette entité externe.
- notationname
Nom de la notation de cette entité. (Voir
xml_set_notation_decl_handler().)
Si un gestionnaire reçoit une chaîne vide ou FALSE,
c'est qu'il est en train d'être désactivé.
xml_set_unparsed_entity_decl_handler() retourne
TRUE si le gestionnaire est actif, et
FALSE sinon, ou si parser
n'est pas un analyseur.
Note : À la place d'un nom de fonction,
un tableau contenant une référence d'objet et un nom de méthode peut aussi
être utilisé.
