Porovnávané verzie

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.

Funkcia %XML_GetElementsByTagName


Funkcia
Funkcia vráti handle na zoznam potomkov XML elementu vyhovujúcich zadaným parametrom.
Deklarácia
Blok kódu
languageesl
themeConfluence
INT %XML_GetElementsByTagName(
   INT in node,
   TEXT in masktagName,
 [ TEXT in namespace := "" ]
 )
Parametre
nodeHandle na rodičovský XML uzol.
mask
tagName
Vzorová maska elementu.
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.
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
masky
mena elementu.
Návratová hodnota
Handle na zoznam XML elementov.
Popis
Funkcia  Funkcia vráti handle na zoznam potomkov XML elementu vyhovujúcich zadanej maske mena zadanému menu elementu a mena namespace alebo jeho prefixu. Prehľadávanie sa deje rekurzívne do hĺbky.
Príklad
Blok kódu
languageesl
themeRDark
 INT _listElements

  ; Vráti handle na zoznam elementov so zadaným názvom.  
  _listElements := %XML_GetElementsByTagName(_doc, "elem*element")
 ; napr.: <element>, <element2>
 
 
 ; Vráti handle na zoznam elementov, ktoréso zodpovedajúzadaným maske menanázvom. Formálne sa rovná prvej deklarácii.
 
 _listElements := %XML_GetElementsByTagName(_doc, "elem*element", "") 
 ; napr.: <element> , <element2>
 
 
 ; Vráti handle na zoznam elementov, ktoréso zodpovedajúzadaným maske menanázvom, pričom ignoruje namespaces.
 
 _listElements := %XML_GetElementsByTagName(_doc, "elem*element", "*") 
 ; napr.: <h:element>, <t:element2>element>, <element>
  
 
 
 ; Vráti handle na zoznam elementov, ktoréso zadaným zhodnénázvom sv danou maskou a rovné zadanom namespace alebo jeho prefixu.
 
 _listElements := %XML_GetElementsByTagName(_doc, "elem*element", "t") 
 ; napr.: <t:element>