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> 

Napíšte komentár