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

node	Handle na rodičovský XML uzol.
tagName	Meno elementu, ktoré sa vyhľadáva. Hodnota `"*"` znamená všetky elementy. Porovnávanie mena akceptuje iba plnú zhodu, nepodporuje regexp ani wildcard výrazy.
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 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