version 2004.2 (Modifiée)
DOM Lire element XML frere suivant (refElément{; nomElémentFrère{; valeurElémentFrère}}) Chaîne
Paramètre | Type | Description | |
refElément | Chaîne | Référence d'élément XML | |
nomElémentFrère | Chaîne | Nom de l'élément XML frère | |
valeurElémentFrère | Chaîne | Valeur de l'élément XML frère | |
Résultat | Chaîne | Référence de l'élément XML frère (16 caractères) |
Description
La commande DOM Lire element XML frere suivant retourne une référence vers le prochain "frère" de l'élément XML passé en référence. Cette référence pourra être utilisée avec les autres commandes d'analyse XML.
Les paramètres nomElémentFrère et valeurElémentFrère, s'ils sont passés, reçoivent respectivement le nom et la valeur de l'élément "frère".
Cette commande permet de naviguer parmi les "enfants" d'un élément XML.
Après le dernier "frère", la variable système OK prend la valeur 0.
Exemples
(1) Récupération de la référence de l'élément XML frère suivant l'élément passé en paramètre :
C_ALPHA(16;$ref_XML_Parent;$ref_XML_Suivant) $ref_XML_Suivant:=DOM Lire element XML frere suivant($ref_XML_Parent)
(2) Récupération dans une boucle des références de tous les éléments XML enfants de l'élément parent passé en paramètre, à compter du premier enfant :
C_ALPHA(16;$ref_XML_Parent;$ref_XML_Premier;$ref_XML_Suivant) $ref_XML_Premier:=DOM Lire premier element XML enfant($ref_XML_Parent) $ref_XML_Suivant:=$ref_XML_Premier Tant que (OK=1) $ref_XML_Suivant:=DOM Lire element XML frere suivant($ref_XML_Suivant) Fin tant que
Référence
DOM Lire premier element XML enfant.
Variables et ensembles système
Si la commande a été correctement exécutée et si l'élément analysé n'est pas le dernier "frère" de l'élément référencé, la variable système OK prend la valeur 1. Si une erreur se produit ou si l'élément analysé est le dernier "frère" de l'élément référencé, elle prend la valeur 0.