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
Pridať komentár