From WikiChip
Difference between revisions of "mirc/identifiers/$isnumber"
(→Synopsis) |
|||
(5 intermediate revisions by the same user not shown) | |||
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. | ||
+ | |||
+ | '''Note''': switches affects the range number parameters, see the examples | ||
+ | |||
== Synopsis == | == Synopsis == | ||
<source lang="mIRC"> | <source lang="mIRC"> | ||
− | $isnumber(text,[ | + | $isnumber(text,[sd],[I,J])</source> |
+ | |||
== Parameters == | == Parameters == | ||
− | '''text''' - The input string to be checked<br /> | + | * '''text''' - The input string to be checked<br /> |
− | ''' | + | * '''s''' - also permits +- sign to be used |
+ | * '''d''' - also permits the decimal, allowing numbers with fractions | ||
+ | * '''[I,J]''' - If you pass a third and fourth parameters, they must be valid number (with respect to the switches used) and are used to validate the number in a range. | ||
+ | |||
== Properties == | == Properties == | ||
None | None | ||
+ | |||
== Example == | == Example == | ||
<source lang="mIRC">//echo -a $isnumber(564)</source> | <source lang="mIRC">//echo -a $isnumber(564)</source> | ||
Line 16: | Line 24: | ||
<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 characters are digits |
− | |||
− | |||
<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') |
− | |||
− | |||
− | |||
− | |||
− | |||
− | // | + | <pre>//echo -a $isnumber(3,d,2.1,4) vs $isnumber(3,,2.1,4)</pre> |
+ | result: $false vs error, the d switches is required not only to allow decimal in the input, but in each range parameter as well | ||
− | |||
− | |||
− | |||
== Compatibility == | == Compatibility == | ||
{{mIRC compatibility|7.58}} | {{mIRC compatibility|7.58}} | ||
== See also == | == See also == | ||
* {{mIRC|$calc}} | * {{mIRC|$calc}} | ||
+ | * {{mIRC|$isnum}} |
Latest revision as of 23:58, 16 August 2022
Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
$isnumber Returns $true if text is a number, otherwise returns $false.
Note: switches affects the range number parameters, see the examples
Synopsis[edit]
$isnumber(text,[sd],[I,J])
Parameters[edit]
- text - The input string to be checked
- s - also permits +- sign to be used
- d - also permits the decimal, allowing numbers with fractions
- [I,J] - If you pass a third and fourth parameters, they must be valid number (with respect to the switches used) and are used to validate the number in a range.
Properties[edit]
None
Example[edit]
//echo -a $isnumber(564)
will return $true
//echo -a $isnumber(abcdefG)
will return $false because not all the characters are digits
//var %a -123 | echo -a $isnumber(%a) vs $isnumber(%a,s)
result: $false vs $true (using a sign requires 's')
//echo -a $isnumber(3,d,2.1,4) vs $isnumber(3,,2.1,4)
result: $false vs error, the d switches is required not only to allow decimal in the input, but in each range parameter as well
Compatibility[edit]
Added: mIRC v7.58
Added on: 17 Nov 2019
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.