XML_GetElementsByTagName
Funkcia %XML_GetElementsByTagName
Funkcia
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> Súvisiace stránky: