Funkcia vráti handle na zoznam potomkov XML elementu vyhovujúcich zadaným
parametrom.
Deklarácia
INT %XML_GetElementsByTagName(
INT in node,
TEXT in mask,
[ TEXT in namespace := "" ]
)
Parametre
node
Handle na rodičovský XML uzol.
mask
Vzorová maska elementu.
namespace
Nepovinný parameter definujúci meno namespace alebo prefix daného elementu. Prázdny parameter sa použije v prípade, že XML neobsahuje
namespace.
Parameter s hodnotou “*” sa použije v prípade, že nie je potrebné explicitne zohľadniť
namespace a vyhľadávanie sa vykoná iba na základe masky mena elementu.
Návratová hodnota
Handle na zoznam XML elementov.
Popis
Funkcia vráti handle na zoznam potomkov XML elementu vyhovujúcich zadanej maske mena elementu a mena namespace alebo jeho prefixu. Prehľadávanie sa deje
rekurzívne do hĺbky.
Príklad
INT _listElements
_listElements := %XML_GetElementsByTagName(_doc, "elem*")
; napr.: <element>, <element2>
; Vráti handle na zoznam elementov, ktoré zodpovedajú maske mena. Formálne sa rovná prvej deklarácii.
_listElements := %XML_GetElementsByTagName(_doc, "elem*","")
; napr.: <element> , <element2>
; Vráti handle na zoznam elementov, ktoré zodpovedajú maske mena, pričom ignoruje namespaces.
_listElements := %XML_GetElementsByTagName(_doc, "elem*","*")
; napr.: <h:element>, <t:element2>, <element>
; Vráti handle na zoznam elementov, ktoré sú zhodné s danou maskou a rovné namespace alebo jeho prefixu.
_listElements := %XML_GetElementsByTagName(_doc, "elem*","t")
; napr.: <t:element>