Editing mirc/identifiers/$istok

{{mirc title|$istok identifier}}'''$istok''' returns $true if a matching token exists, or $false if it does not.


== Synopsis ==
<pre>$istok(<LIST>,<Token>,<C>)</pre>

== Parameters ==
'''LIST:''' - Text list delimited by a character into tokens<br />
'''Token:''' - The token searched for in LIST<br />
'''C:''' - The {{mIRC|$asc|$asc()}} value which splits TEXT into tokens<br />

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 {{mIRC|$istokcs|$istokcs}} which has the same syntax}}

== Properties ==
None

== Examples ==
<pre>//if ($event isin CONNECT JOIN) goto LABEL</pre>

If this alias is executed in the {{mIRC|on events/on CONNECT|ON CONNECT}} and {{mIRC|on events/on DISCONNECT|ON DISCONNECT}} events, this triggers on BOTH events because {{mIRC|isin|isin}} matches on CONNECT being a substring of DISCONNECT. Better is:
<pre>//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.
</pre>

<pre>//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
</pre>

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

'''Note:''' Even though {{mIRC|$upper|$upper}} and {{mIRC|$lower|$lower}} treat $chr(201) and $chr(233) as UPPER/lower forms of the same letter, $istok does not return $true when trying to match these 2 characters:

<pre>//var %name Chlo $+ $chr(233) | echo -a %name $istok($upper(%name) Suzy,%name,32)
; returns false because the case-insensitive search does not match $chr(233) against $chr(201)
</pre>

To have CHLOÉ and chloé both match as $true, use {{mIRC|$upper|$upper(TOKEN)}} and a capitalized LIST:

<pre>//var %name Chlo $+ $chr(233) | echo -a %name $istok(CHLO $+ $chr(201) Suzy,$upper(%name),32)
; returns $true because $upper converted $chr(233) to $chr(201)
</pre>

== Compatibility ==
{{mIRC compatibility|5.5}}

== See also ==
* {{mIRC|$addtok}}
* {{mIRC|$deltok}}
* {{mIRC|$findtok}}
* {{mIRC|$gettok}}
* {{mIRC|$instok}}
* {{mIRC|$istokcs}}
* {{mIRC|$matchtok}}
* {{mIRC|$numtok}}
* {{mIRC|$puttok}}
* {{mIRC|$remtok}}
* {{mIRC|$reptok}}
* {{mIRC|$sorttok}}
* {{mIRC|$wildtok}}
* [[List of identifiers - mIRC]]
{{mIRC identifier list}}
[[Category:mIRC identifiers|istok]]