From WikiChip
Editing mirc/identifiers/$gettok
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
This page supports semantic in-text annotations (e.g. "[[Is specified as::World Heritage Site]]") to build structured and queryable content provided by Semantic MediaWiki. For a comprehensive description on how to use annotations or the #ask parser function, please have a look at the getting started, in-text annotation, or inline queries help pages.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
− | + | '''$gettok returns the Nth $asc(C)-delimited token from a list''' | |
− | '''$gettok | ||
− | |||
== Synopsis == | == Synopsis == | ||
Line 7: | Line 5: | ||
== Parameters == | == Parameters == | ||
− | '''LIST:''' | + | '''LIST:''' Text list delimited by a character into tokens<br /> |
− | '''N:''' | + | '''N:''' The token(s) to be returned. N can also be negative or a range<br /> |
− | '''C:''' | + | '''C:''' The $asc() value which splits TEXT into tokens<br /> |
− | If N=0, returns total number of tokens, same as | + | If N=0, returns total number of tokens, same as $numtok(TEXT,C)<br /> |
− | If N is greater than the total number of tokens, returns | + | If N is greater than the total number of tokens, returns $nul<br /> |
If N is negative, returns tokens relative to the last token. -1 is the last token, -2 is next-to-last token, etc.<br /> | If N is negative, returns tokens relative to the last token. -1 is the last token, -2 is next-to-last token, etc.<br /> | ||
− | N- returns all tokens beginning with the Nth token. | + | N- returns all tokens beginning with the Nth token. N1-N2 returns all tokens in the range of those 2 numbers, including the between delimiters.<br /> |
− | N1-N2 returns all tokens in the range of those 2 numbers, including the between delimiters.<br /> | ||
− | |||
− | |||
− | |||
== Properties == | == Properties == | ||
+ | |||
None | None | ||
Line 46: | Line 41: | ||
; returns all tokens beginning with the 3rd: Tue.Wed.Thu.Fri.Sat</pre> | ; returns all tokens beginning with the 3rd: Tue.Wed.Thu.Fri.Sat</pre> | ||
− | <pre>//echo -a $gettok( | + | <pre>//echo -a $gettok(1x2x3x4,3,120) |
− | ; returns | + | ; returns 3 because $chr(120) is lower-case x |
− | //echo -a $gettok( | + | //echo -a $gettok(x1xxxx2x3x4x,3,120) |
− | ; also returns | + | ; also returns 3 because duplicate, leading, and trailing delimiters are stripped before $gettok processes the TEXT |
− | //echo -a $gettok( | + | //echo -a $gettok(1x2X3x4,3,120) |
− | ; returns | + | ; returns 4 because the C token is case-sensitive, so capital X isn't a delimiter</pre> |
$gettok allows the range numbers to be negative | $gettok allows the range numbers to be negative | ||
Line 69: | Line 64: | ||
</pre> | </pre> | ||
− | ''' | + | '''NOTE:''' $gettok differs from CSV format in that it does not use double-quotes to allow a delimiter to be part of another token. If you want $filename to be a token in a comma-delimited list of tokens, you should use $replace to change the comma in the filename into another character that cannot appear in the filename before adding as a token, then use $replace on the extracted token to restore any comma(s). |
== Compatibility == | == Compatibility == | ||
Line 75: | Line 70: | ||
== See also == | == See also == | ||
− | {{ | + | * {{mIRC|$numtok}} |
− | | | + | * {{mIRC|$findtok}} |
− | | | + | * {{mIRC|$matchtok}} |
− | | | + | * {{mIRC|$wildtok}} |
+ | * {{mIRC|$istok}} | ||
* {{mIRC|$addtok}} | * {{mIRC|$addtok}} | ||
− | |||
− | |||
* {{mIRC|$instok}} | * {{mIRC|$instok}} | ||
− | |||
− | |||
− | |||
* {{mIRC|$puttok}} | * {{mIRC|$puttok}} | ||
+ | * {{mIRC|$deltok}} | ||
* {{mIRC|$remtok}} | * {{mIRC|$remtok}} | ||
* {{mIRC|$reptok}} | * {{mIRC|$reptok}} | ||
* {{mIRC|$sorttok}} | * {{mIRC|$sorttok}} | ||
− | * | + | * [[List of identifiers - mIRC]] |
− | |||
− | [[List of identifiers - mIRC | ||
{{mIRC identifier list}} | {{mIRC identifier list}} | ||
− |