Revision as of 12:21, 2 May 2020

$istok returns $true if a matching token exists, or $false if it does not.

Synopsis

$istok(<LIST>,<Token>,<C>)

Parameters

LIST: - Text list delimited by a character into tokens
Token: - The token searched for in LIST
C: - The $asc() value which splits TEXT into tokens

The search is for entire token, not partials, and the search is NOT case-sensitive. If you need the token search to be case-sensitive, use $istokcs which has the same syntax}}

Properties

None

Examples

//if ($event isin CONNECT JOIN) goto LABEL

If this alias is executed in the on connect and on disconnect events, this triggers on BOTH events because isin matches on CONNECT being a substring of DISCONNECT. Better is:

//if ($istok(CONNECT JOIN,$event,32)) goto LABEL
; searches for exact match of the value of the $event string against the tokens in the space-delimited list of tokens.

//var %filename spreadsheet.xls | var %filetype $gettok($noqt(%filename),-1,46) | echo -a %filetype $istok(xlsx xlsm,%filetype,32)
; returns false because $istok does not match the substring xls against the token xlsx

//echo -a $asctime($ctime,dddd) $istok(SUNDAY MONDAY TUESDAY WEDNESDAY THURSDAY FRIDAY SATURDAY,$asctime($ctime,dddd),32)
; returns $true because match is case-insensitive

Compatibility

Added: mIRC v5.5
Added on: 08 Jan 1999
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See also

• $addtok
• $deltok
• $findtok
• $gettok
• $instok
• $istok
• $matchtok
• $numtok
• $puttok
• $remtok
• $reptok
• $sorttok
• $wildtok
• List of identifiers - mIRC