Manuel PHP
Précédent |  | Suivant

# xml_set_element_handler

(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.

Précédent | Sommaire | Suivant
xml_set_object | Niveau supérieur | xml_set_character_data_handler