(3.0.6 - 3.0.18 only, PHP 4 >= 4.0.0)
xml_set_element_handler -- Affecte les gestionnaires de début et de fin.
Description
int xml_set_element_handler ( resource parser, string startElementHandler, string endElementHandler)
xml_set_element_handler() affecte les gestionnaires
de début et de fin de l'analyseur XML
parser. startElementHandler
et endElementHandler sont des chaînes qui
contiennent les noms de fonctions qui existent lorsque
xml_parse() est appelé pour créer
parser.
La fonction startElementHandler doit
accepter trois paramètres:
startElementHandler ( resource parser, string name, array attribs)
parser
Le premier paramètre, parser, est une
référence sur l'analyseur XML qui appelle cette fonction.
name
Le deuxième paramètre, name, contient
le nom de l'élément qui a provoqué l'appel du
gestionnaire. Si l'analyseur gère la
casse, cet élément
sera en majuscule.
attribs
Le troisième paramètre, attribs,
contient un tableau associatif avec les attributs de
l'éléments (s'il en existe). Les clés de ce tableau
seront les noms des attributs, et les valeurs seront les valeurs
correspondantes des attributs. Les noms des attributs seront mis en
majuscule si l'analyseur gère la
casse. Les valeurs des attributs
seront intouchées.
L'ordre original des attributs peut être retrouvé en
passant en revue le tableau attribs, avec
la fonction each(). La première clé
sera la première clé du tableau.
La fonction endElementHandler doit accepter deux
paramètres:
endElementHandler ( resource parser, string name)
parser
Le premier paramètre, parser, est une
référence sur l'analyseur XML qui appelle cette fonction.
name
Le second paramètre, name, contient le
nom de l'élément qui a provoqué l'appel du
gestionnaire. Si l'analyseur gère la
casse, cet
élément sera en majuscule.
Si un gestionnaire reçoit une chaîne vide, ou FALSE,
c'est qu'il est en train d'être désactivé.
xml_set_element_handler() retourne TRUE
si le gestionnaire est actif, et FALSE sinon, ou si
parser n'est pas un analyseur.
Il n'est pas pour l'instant possible d'utiliser des objets pour servir de
gestionnaire. Reportez-vous à xml_set_object() pour
utiliser l'analyseur XML depuis un objet.
