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

bool xml_set_element_handler ( resource $parser , callback $start_element_handler , callback $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� pour cr�er parser .

Liste de param�tres

parser

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�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 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 tableau attribs , 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, FALSE en cas d'�chec.

Fonctions d'analyse de fichier XML
PHP Manual