xml_set_unparsed_entity_decl

Manuel PHP
Précédent		Suivant

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 cet entité externe.
public_id: Identifiant public pour cet 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 : A 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é.

Précédent	Sommaire	Suivant
xml_set_start_namespace_decl_handler	Niveau supérieur	XML-RPC