xml_set_element_handler
(PHP 4, PHP 5)
xml_set_element_handler — Affecte les gestionnaires de début et de fin de balise XML
Description
$parser
, callable $start_element_handler
, callable $end_element_handler
)
Affecte les gestionnaires de début et de fin de l'analyseur XML
parser
. start_element_handler
et end_element_handler
sont des chaînes qui
contiennent les noms de fonctions qui existent lorsque
xml_parse() est appelée pour créer
parser
.
Liste de paramètres
-
parser
-
Une référence d'analyseur XML à définir comme fonction gérant les éléments de début et de fin.
-
start_element_handler
-
La fonction
start_element_handler
doit accepter trois paramètres :start_element_handler ( 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 majuscules. -
attribs
-
Le troisième paramètre,
attribs
, contient un tableau associatif avec les attributs de l'élément (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 majuscules si l'analyseur gère la casse. Les valeurs des attributs seront inchangées. L'ordre original des attributs peut être retrouvé en passant en revue le tableauattribs
, avec la fonction each(). La première clé sera la première clé du tableau.
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é.
-
-
end_element_handler
-
La fonction
endelementhandler
doit accepter deux paramètres :end_element_handler ( 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 majuscules.
Si un gestionnaire reçoit une chaîne vide, ou
FALSE
, c'est qu'il est en train d'être désactivé. -
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.