gettoken()

    
Also See:   asciichar asciivalue crypto_base64_decode crypto_base64_encode decodeattribute decodeentities encodeattribute encodeentities encodejavascriptstring glosub glosub_array indexof indexofi indexofl indexofli isalnum isalpha isascii iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit keyword_extract keyword_extract_merge keyword_extract_merge_init keyword_extract_merge_results keyword_in len len_var ltrim miva_cdata_encode miva_csv_encode miva_hex_decode miva_hex_encode miva_html_strip miva_joinstring miva_json_decode miva_json_decode_last_error miva_splitstring padl padr rtrim slugify substring substring_var tokenize tolower toupper trim

Report a language bug  |  Report a documentation error
Returns the nth number token (i.e. substring) of a delimited_string using characters as token separators. A null string is returned if there is no nth token. Common delimiter characters are comma, tab, linefeeds, pipe but are not limited to these.
Syntax 
gettoken( delimited_string, characters, position_num )
Returns the position_num token (i.e. substring) of a delimited_string delimited by characters.
  • delimited_string = A string delimited by a character or characters
  • characters = the delimiter character or characters
  • position_num = the position of the substring you want to return
+ Add a note
User Annotations: gettoken
Ray Yates : mivascript at, pcinet d0t com
09/10/2011 20:01 p.m. 
Given this pipe delimited string: gettoken('a|b|c|d|e', '|', 3) returns "c"

Where s.tm_mon is a system variable that contains the numeric month of the year (1 to 12) this function will return an abreviation of the current month from the space delimited string.

gettoken('Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec,' ',s.tm_mon)

Sometime it is usefull to know how many tokens are in a string. The GettokenCount() function below can be used to get than number.
<MvFUNCTION NAME = "GettokenCount" PARAMETERS = "text_string, separator" STANDARDOUTPUTLEVEL = "">
    <MvFUNCRETURN VALUE = "{ (len(l.text_string) - len(glosub(l.text_string, l.separator,''))) + 1 }">
</MvFUNCTION>