%GetStrItem function

Function

The function returns the word on the specified position in a text string, while the words are divided by the specified delimiter.

Declaration

TEXT %GetStrItem(
   TEXT in string, 
   INT 	in seq_number,
   TEXT in delimiter,
   BOOL	in bTrim := @TRUE
 )

Parameters

string	Text string.
seq_number	Sequence number of word.
delimiter	Delimiter.
bTrim	@TRUE - The returned word will be trimmed. @FALSE - The returned word will not be trimmed.

Example

%GetStrItem("John;Michael;Charles;Jack;Martin",3,";") 				 ; the function returns the value of "Charles"
%GetStrItem("John;Michael;  Charles ;Jack;Martin",3,";") 			; the function returns the value of "Charles"
%GetStrItem("John;Michael;  Charles ;Jack;Martin",3,";", @FALSE) 	; the function returns the value of "  Charles "