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 tagName,
 [ TEXT in namespace := "" ]
 )
Parametre
nodeHandle na rodičovský XML uzol.
tagNameMeno elementu, ktoré sa vyhľadáva. Hodnota "*" znamená všetky elementy. Porovnávanie mena akceptuje iba plnú zhodu, nepodporuje regexp ani wildcard výrazy.
namespaceNepovinný 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 mena elementu.
Návratová hodnota
Handle na zoznam XML elementov.
Popis
 Funkcia vráti handle na zoznam potomkov XML elementu vyhovujúcich zadanému menu elementu a mena namespace alebo jeho prefixu. Prehľadávanie sa deje rekurzívne do hĺbky.
Príklad
 INT _listElements

  ; Vráti handle na zoznam elementov so zadaným názvom.  
 _listElements := %XML_GetElementsByTagName(_doc, "element")
 
 
 ; Vráti handle na zoznam elementov so zadaným názvom. Formálne sa rovná prvej deklarácii. 
 _listElements := %XML_GetElementsByTagName(_doc, "element", "") 
 
 
 ; Vráti handle na zoznam elementov so zadaným názvom, pričom ignoruje namespaces.
 _listElements := %XML_GetElementsByTagName(_doc, "element", "*") 
 ; napr.: <h:element>, <t:element>, <element>
 
 
  ; Vráti handle na zoznam elementov so zadaným názvom v zadanom namespace alebo jeho prefixu. 
 _listElements := %XML_GetElementsByTagName(_doc, "element", "t") 
 ; napr.: <t:element>

Súvisiace stránky:

Funkcie pre prácu s XML súbormi
Argumenty funkcie - typy

Napíšte komentár