Description
int xml_set_element_handler(int parser, string startElementHandler, string endElementHandler);
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 le parser.
La fonction startElementHandler doit accepter trois paramètres:
startElementHandler(int parser, string name, string 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, contiens 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 (si il en exite). Les clés de ce tableau seront les noms des attribus, et les valeurs seront les valeurs correspondantes des attributs. Les noms des attributs seront mis en majuscule si l'analyseur le gère. Les valeurs des attributs seront intouchées.
L'ordre original des attributs peut être retourné en passant en revue le tableau de manière classique, avec each(). La première clé du tableau était le premier attribut rencontréÖ etc.
La fonction endElementHandler doit accepter trois paramètres:
endElementHandler(int 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 paramtre, name, contiens 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 recoit une chaîne vide, ou faux (false), c'est qu'il est en train d'être désactivé.
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 gestionnaires.
