|
XML_GET_CHILD_COUNT |
Lecture ou modification d'objets |
XML_GET_LAST_CHILD |
|
Fonction de script : Détermine le premier sous-élément d'un élément
XML_GET_FIRST_CHILD (Reference)
|
Syntaxe |
Description / format |
|---|---|
|
Référence |
Référence à l'élément dont vous souhaitez déterminer le sous-élément Format : littéral de script ou variable de script |
|
Code retour |
|---|
|
Réfère au premier sous-élément |
La fonction de script identifie le premier sous-élément d'un élément dans le document XML.
Un descripteur doit être transmis à la fonction de script pour qu'elle puisse accéder au premier sous-élément approprié. Cette référence est utilisée par certains scripts pour se positionner dans le document XML et le modifier. Le tout premier descripteur est celui retourné par XML_OPEN. Il renvoie, par exemple, à l'élément racine Content de la documentation structurée.
Si XML_GET_FIRST_CHILD décale le positionnement d'un niveau vers la droite dans la structure, XML_GET_NEXTSIBLING sert à déterminer l'élément de même niveau suivant.
Dans l'exemple suivant, le nom du premier sous-élément "Description" est récupéré.
:SET &XMLDOCU# = XML_OPEN(DOCU,"ON_CALL","@Details")
:SET &HND# = XML_GET_FIRST_CHILD(&XMLDOCU#)
: IF &HND# <> ""
: SET &NAME#
= XML_GET_NODE_NAME(&HND#)
: PRINT "sub-element: &NAME#"
: ELSE
: PRINT "No sub-element"
: ENDIF
:XML_CLOSE
Rubriques connexes :
| Elément de script | Description |
|---|---|
| XML_GET_LAST_CHILD | Détermine le dernier sous-élément d'un élément. |
| Détermine l'élément suivant. |
Eléments de script - Lecture ou modification d'objets
Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle