xml_parse
Commence l'analyse d'un document XML
&reftitle.description;
intxml_parse
XMLParserparser
stringdata
boolis_final&false;
xml_parse analyse un document XML. Les gestionnaires
pour les événements configurés sont appelés autant de fois que nécessaire.
&reftitle.parameters;
parser
Une référence sur l'analyseur XML à utiliser.
data
Une partie des données à analyser. Un document peut être analysé
morceau par morceau par appels successifs à
xml_parse avec de nouvelles données, aussi longtemps
que le paramètre is_final est défini et &true;
lorsque les dernières données sont analysées.
is_final
Si défini et vaut &true;, data sera le dernier
morceau de données envoyées à l'analyseur.
&reftitle.returnvalues;
Retourne 1 en cas de succès ou 0 en cas d'échec.
Lors d'un échec d'analyse, la cause de l'erreur peut être obtenue grâce
aux fonctions
xml_get_error_code,
xml_error_string,
xml_get_current_line_number,
xml_get_current_column_number et
xml_get_current_byte_index.
Quelques erreurs (dont les erreurs d'entités) sont
reportées à la fin des données, ceci uniquement
si is_final vaut &true;.
&reftitle.changelog;
&Version;
&Description;
&xml.changelog.parser-param;
&reftitle.examples;
Analyse de gros documents XML par morceaux
Cet exemple montre comment les gros documents XML peuvent être lus et
analysés en morceaux, permettant ainsi de ne pas conserver en mémoire
la totalité du document. Aucun gestionnaire d'erreur n'a été positionné
pour rendre l'exemple plus concis.