SAX GET XML ELEMENT
SAX GET XML ELEMENT ( document ; nom ; préfixe ; nomsAttributs ; valeursAttributs )
| Paramètre | Type | Description | |
|---|---|---|---|
| document | RefDoc | 🡒 | Référence du document ouvert |
| nom | Chaîne | 🡘 | Nom de l’élément |
| préfixe | Chaîne | 🡘 | Espace de nommage |
| nomsAttributs | Tableau chaîne | 🡘 | Noms des attributs |
| valeursAttributs | Tableau chaîne | 🡘 | Valeurs des attributs |
Description
La commande SAX GET XML ELEMENT retourne diverses informations relatives à l’élément nom présent dans le document XML référencé par document. Elle doit être appelée dans le contexte d’un événement SAX XML start element ou XML end element. Dans le cas particulier d’un XML end element, les paramètres d’attributs ne sont pas gérés. Pour plus d'informations sur les événements SAX, reportez-vous à la description de la commande SAX Get XML node.
nom contient le nom de l’élément.
préfixe retourne l’espace de nommage (namespace) de l’élément. Ce paramètre est vide si aucun espace de nommage n’est associé à l’élément.
La commande remplit le tableau nomsAttributs avec les noms des attributs de l’élément cible. Si nécessaire, la commande crée et dimensionne automatiquement le tableau.
La commande remplit également le tableau valeursAttributs avec les valeurs des attributs de l’élément cible. Si nécessaire, la commande crée et dimensionne automatiquement le tableau.
Exemple
Considérons l’extrait de code XML suivant :
MonTexte
Une fois l’instruction suivante exécutée :
SAX GET XML ELEMENT(RefDoc;vNom;vPréfixe;tAttrNoms;tAttrValeurs)
...vNom contiendra “Child”
vPréfixe contiendra “”
tAttrNoms{1} contiendra “Att1”, tAttrNoms{2} contiendra “Att2”, tAttrNoms{3} contiendra “Att3”
tAttrValeurs{1} contiendra “111”, tAttrValeurs{2} contiendra “222”, tAttrValeurs{3} contiendra “333”
Variables et ensembles système
Si la commande a été exécutée correctement, la variable système OK prend la valeur 1, sinon elle prend la valeur 0 et une erreur est générée.