Funkcia vráti slovo z textového reťazca na danej pozícii, pričom slová sú oddelené daným oddeľovačom.
Deklarácia
TEXT %GetStrItem(
TEXT in string,
INT in seq_number,
TEXT in delimiter,
BOOL in bTrim := @TRUE,
TEXT in quoteChar := '"'
)
Parametre
string
Textový reťazec.
seq_number
Poradové číslo slova.
delimiter
Oddeľovač.
bTrim
@TRUE - Vo vrátenom slove buduú z oboch strán orezané medzery.
@FALSE - Vo vrátenom slove nebudú orezané medzery.
quoteChar
Znak pre úvodzovky (štandardne znak "). Ak sa nachádza delimiter v rámci úvodzoviek, neberie sa do úvahy. Navyše, ak je výsledné slovo v úvodzovkách, budú orezané. Ak je zadaný quoteChar ako prázdny reťazec, úvodzovky sa neberú do úvahy. Ak je zadaný ako viacznakový reťazec, do úvahy sa berie prvý znak. Príklad:
%GetStrItem('A;B;"C;D";E',3,";", @FALSE) ; funkcia vráti hodnotu C;D (úvodzovky na začiatku/konci sú orezané, delimiter medzi úvodzovkami je ignorovaný) %GetStrItem('A;B;"C;D";E',3,";", @FALSE, "") ; funkcia vráti hodnotu "C (vráti aj úvodzovku, delimiter je braný do úvahy) %GetStrItem('A;B;"C;D";E',4,";", @FALSE, "") ; funkcia vráti hodnotu D" (vráti aj úvodzovku, delimiter je braný do úvahy)
Príklad
%GetStrItem("Jano;Ivan;Karol;Jozef;Martin",3,";") ; funkcia vráti hodnotu "Karol"
%GetStrItem("Jano;Ivan; Karol ;Jozef;Martin",3,";") ; funkcia vráti hodnotu "Karol"
%GetStrItem("Jano;Ivan; Karol ;Jozef;Martin",3,";", @FALSE) ; funkcia vráti hodnotu " Karol "