(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
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é.
Précédent | Sommaire | Suivant |
xml_set_start_namespace_decl_handler | Niveau supérieur | XML-RPC |