Funkcia %XML_GetElementText


Funkcia
Funkcia vráti textový reťazec uložený v XML elemente.
Deklarácia
TEXT %XML_GetElementText(
   INT in node,
   TEXT in element,
 [ TEXT in namespace := ”” ]
 )

Parametre
node Handle na rodičovský XML uzol alebo XML zoznam.
element Názov elementu, z ktorého sa získa text.
namespace Nepovinný parameter definujúci namespace alebo prefix XML elementu. 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
 
Popis
Funkcia vráti textový reťazec uložený v XML elemente, definovanom názvom elementu a názvom namespace, resp. jeho prefixom. V prípade, že zadaným parametrom vyhovuje viac ako jeden element, funkcia vráti neplatnú hodnotu.
Vyhľadávanie sa deje rekurzívne do hĺbky, preto je vhodné, aby handle na rodičovský element bol v hierarchickej XML štruktúre čo najbližšie k žiadanému XML elementu. V prípade, že funkcia vráti neplatný výsledok, je možné sa o chybe, ktorá nastala, dozvedieť zavolaním funkcie %XML_GetLastErrorMessage.
Príklad
TEXT _errorCodeText 
 TEXT _text 
 _text := %XML_GetElementText(_doc,"td","h")
 IF (!_text\VLD) THEN 
 _errorCodeText := %XML_GetLastErrorMessage()
 ENDIF 

Napíšte komentár