CatchXML

CatchXML()

Syntaxe

Resultat = CatchXML(#XML, *Adresse, Taille [, Options [, Encodage]])

Description

Crée un arbre XML à partir d'un code XML déjà chargé en mémoire.

La création de l'arbre XML peut se faire en une seule fois, ou de manière progressive par exemple lors de la réception d'un flux XML par le réseau.

Arguments

#XML L'arbre XML à utiliser.

#PB_Any peut être utilisé pour générer automatiquement ce numéro.

*Adresse L'adresse d'une zone mémoire valide.

Taille La taille en octets de la zone mémoire.
Options (optionnel)
Si ce paramètre est omis, la zone mémoire doit être suffisamment grande pour contenir toutes les données XML.
Pour interpréter un flux XML en plusieurs fois, les options suivantes sont disponibles:
  #PB_XML_StreamStart: Démarre l'interprétation du premier bloc
  #PB_XML_StreamNext : Continue l'interprétation avec un nouveau bloc
  #PB_XML_StreamEnd  : Termine l'interprétation après ce bloc
Lors de l'appel de cette fonction avec l'option #PB_XML_StreamStart ou #PB_XML_StreamEnd, le paramètre 'Taille' peut être égal à 0.

A noter que lors de l'interprétation par blocs, toute donnée fournie est immédiatement accessible dans l'arbre XML avant même que l'appel avec #PB_XML_StreamEnd n'ait eu lieu.
Encodage (optionnel)
Force l'encodage de l'arbre XML quelque soit celui trouvé dans la déclaration XML. (la déclaration XML est modifiée selon l'encodage choisi).
  #PB_UTF8 (Par défaut) 
  #PB_Ascii
  #PB_Unicode 
Ce paramètre devra être utilisé lorsque le document n'a pas de déclaration XML, ou si l'information d'encodage est fournie en dehors du document XML, par exemple à travers un en-tête de type "mime" d'un protocole de communication.

Valeur de retour

Cette commande renvoie 0 seulement lors d'options invalides ou si une zone de mémoire est corrompue.
Pour vérifier les erreurs d'interprétation, utiliser XMLStatus(). Dans le cas d'une erreur d'interprétation, toutes les données correctement lues avant l'erreur sont quand même disponibles dans l'arbre XML.

Voir aussi

FreeXML(), CreateXML(), LoadXML(), ParseXML()

OS Supportés

Tous

XML Index - ChildXMLNode() ->

#XML	L'arbre XML à utiliser. #PB_Any peut être utilisé pour générer automatiquement ce numéro.
*Adresse	L'adresse d'une zone mémoire valide.
Taille	La taille en octets de la zone mémoire.
Options (optionnel)	Si ce paramètre est omis, la zone mémoire doit être suffisamment grande pour contenir toutes les données XML. Pour interpréter un flux XML en plusieurs fois, les options suivantes sont disponibles: #PB_XML_StreamStart: Démarre l'interprétation du premier bloc #PB_XML_StreamNext : Continue l'interprétation avec un nouveau bloc #PB_XML_StreamEnd : Termine l'interprétation après ce bloc Lors de l'appel de cette fonction avec l'option #PB_XML_StreamStart ou #PB_XML_StreamEnd, le paramètre 'Taille' peut être égal à 0. A noter que lors de l'interprétation par blocs, toute donnée fournie est immédiatement accessible dans l'arbre XML avant même que l'appel avec #PB_XML_StreamEnd n'ait eu lieu.
Encodage (optionnel)	Force l'encodage de l'arbre XML quelque soit celui trouvé dans la déclaration XML. (la déclaration XML est modifiée selon l'encodage choisi). #PB_UTF8 (Par défaut) #PB_Ascii #PB_Unicode Ce paramètre devra être utilisé lorsque le document n'a pas de déclaration XML, ou si l'information d'encodage est fournie en dehors du document XML, par exemple à travers un en-tête de type "mime" d'un protocole de communication.