4D Doc Center : DOM Lire element XML frere suivant

4D v14.3

DOM Lire element XML frere suivant


DOM Lire element XML frere suivant ( refElément {; nomElémentFrère {; valeurElémentFrère}} ) -> Résultat

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.

Exemple 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_TEXTE($ref_XML_Parent;$ref_XML_Suivant)

 $ref_XML_Suivant:=DOM Lire element XML frere suivant($ref_XML_Parent)

Exemple 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_TEXTE($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

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.