Lire element XML suivant

version 2003

Lire element XML suivant (refElément{; nomElémentEnf{; valeurElémentEnf}}) Chaîne

Paramètre	Type		Description
refElément	Chaîne		Référence d'élément XML
nomElémentEnf	Chaîne		Nom du champ sélectionné
valeurElémentEnf	Chaîne		Valeur du champ sélectionné
Résultat	Chaîne		Référence de l'élément XML (16 caractères)

La commande Lire element XML suivant retourne une référence vers le prochain "enfant" 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émentEnf et valeurElémentEnf, s'ils sont passés, reçoivent respectivement le nom et la valeur de l'élément "enfant".

Cette commande permet d'analyser successivement tous les "enfants" de l'élément XML passé en paramètre.

Après le dernier "enfant", la variable système OK prend la valeur 0.

(1) Récupération de la référence de l'élément XML suivant l'élément passé en paramètre :

   C_ALPHA(16;$ref_XML_Parent;$ref_XML_Suivant)
   $ref_XML_Suivant:=Lire element XML suivant($ref_XML_Parent)

(2) Récupération dans une boucle des références des éléments XML suivant l'élément parent passé en paramètre :

   C_ALPHA(16;$ref_XML_Parent;$ref_XML_Premier;$ref_XML_Suivant)

   $ref_XML_Premier:=Lire premier element XML($ref_XML_Parent)
   $ref_XML_Suivant:=$ref_XML_Premier
   Tant que (OK=1)
      $ref_XML_Suivant:=Lire element XML suivant($ref_XML_Suivant)
   Fin tant que

Lire premier element XML.

Si la commande a été correctement exécutée et si l'élément analysé n'est pas le dernier "enfant" 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 "enfant" de l'élément référencé, elle prend la valeur 0.