From WikiChip
Editing mirc/identifiers/$isnumber
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: | ||
{{mirc title|$isnumber Identifier}}'''$isnumber''' Returns $true if text is a number, otherwise returns $false. | {{mirc title|$isnumber Identifier}}'''$isnumber''' Returns $true if text is a number, otherwise returns $false. | ||
− | |||
− | |||
− | |||
== Synopsis == | == Synopsis == | ||
<source lang="mIRC"> | <source lang="mIRC"> | ||
− | $isnumber(text | + | $isnumber(text [,csend])</source> |
+ | Note: This documentation is based on trial-and-error, as this is not documented in /help or in versions.txt and I didn't find any mention of it in a Forum post. | ||
+ | == Parameters == | ||
+ | '''text''' - The input string to be checked<br /> | ||
+ | '''csend''' - Switches which expand the types of numbers accepted, multiple switches allowed. Default accepts only integers >= 0 | ||
+ | == Switches == | ||
+ | * n - default when no switches are used. Accepts text consisting of ONLY numbers, allows only non-negative integers | ||
+ | * s - also permits +- sign to be used | ||
+ | * d - also permits the decimal, allowing numbers with fractions | ||
+ | * e - also permits scientific notation only if using lowercase 'e' | ||
+ | * c - combo of using 's' and 'd' and part of the 'e' range, but also accepts a sub-set of the codepoints also recognized by $regex \d when using the /u flag | ||
− | + | Note: 'e' allows the exponent to be preceded by +-, but a leading 'sign' would also require the 'c' or 's' flags too, and doesn't recognize the base10 multiplier containing a decimal unless 'd' also used. 'e' does not recognize 'd' as the exponent the way $int(1d2) returns 100. 'c' recognizes the exponent only when the combined exponent from the leading multiplier and the final exponent does not combine into an exponent larger than e308, probably for the same reason that changing the 308 to 308 in $calc(10^308) changes the result to zero. | |
− | |||
− | |||
− | |||
− | |||
== Properties == | == Properties == | ||
None | None | ||
− | |||
== Example == | == Example == | ||
<source lang="mIRC">//echo -a $isnumber(564)</source> | <source lang="mIRC">//echo -a $isnumber(564)</source> | ||
Line 24: | Line 26: | ||
<source lang="mIRC">//echo -a $isnumber(abcdefG)</source> | <source lang="mIRC">//echo -a $isnumber(abcdefG)</source> | ||
− | will return '''$false''' because not all the | + | will return '''$false''' because not all the character are digit |
+ | <pre>//var %a 1.23e+45 | echo -a $isnumber(%a,e) vs $isnumber(%a,ed)</pre> | ||
+ | result: $false vs $true (because presence of the decimal requires 'd' or 'c' switch) | ||
<pre>//var %a -123 | echo -a $isnumber(%a) vs $isnumber(%a,s)</pre> | <pre>//var %a -123 | echo -a $isnumber(%a) vs $isnumber(%a,s)</pre> | ||
− | result: $false vs $true (using a sign requires 's') | + | result: $false vs $true (using a sign requires 's' or 'c') |
+ | |||
+ | Note: Most users would probably want to use some/all of the 'sdn' switches if there's a risk the string can contain of unwanted false matches with some hex strings triggering a match as if they're using scientific notation, and also because it has a partial subset of unexpected utf8 codepoints matching as if numeric. The next 2 examples shows that the 'c' switch matches 170 UTF8 codepoints, while using \d with $regex's /u switch matches 370. | ||
+ | |||
+ | <pre> | ||
+ | //var %i 1 , %a | while (%i isnum 1-65535) { if ((%i !isnum 55296-57343) && ($isnumber($chr(%i),c))) var %a %a %i | inc %i } | echo -ag %a : $numtok(%a,32) tokens | ||
− | + | //var %i 1 , %a | while (%i isnum 1-65535) { if ((%i !isnum 55296-57343) && ($regex($chr(%i),/^\d$/u))) var %a %a %i | inc %i } | echo -ag %a : $numtok(%a,32) tokens</pre> | |
− | |||
+ | <pre>//var -s %a $lower($crc(LFAX,0)) | echo -a %a is $isnumber(%a,c)</pre> | ||
+ | result: 08436e69 is $true | ||
+ | Recognizes this hex string as numeric because the number following the lowercase 'e' is not large enough to prevent $calc(8436*10^69) to be larger than approx 2^1023.99. | ||
== Compatibility == | == Compatibility == | ||
{{mIRC compatibility|7.58}} | {{mIRC compatibility|7.58}} | ||
== See also == | == See also == | ||
* {{mIRC|$calc}} | * {{mIRC|$calc}} | ||
− |