XML_GetElementText
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 Súvisiace stránky: