From WikiChip
Difference between revisions of "mirc/identifiers/$isnumber"
< mirc‎ | identifiers

(Example)
 
(One intermediate revision by the same user not shown)
Line 5: Line 5:
 
== Synopsis ==
 
== Synopsis ==
 
<source lang="mIRC">
 
<source lang="mIRC">
$isnumber(text,[snd],[I,J])</source>
+
$isnumber(text,[sd],[I,J])</source>
  
  
 
== Parameters ==
 
== Parameters ==
 
* '''text''' - The input string to be checked<br />
 
* '''text''' - The input string to be checked<br />
* '''[snd]''' - Switches allowing for number to be preceded by +- sign and accepting floats
+
* '''s''' - also permits +- sign to be used
** '''s''' - also permits +- sign to be used
+
* '''d''' - also permits the decimal, allowing numbers with fractions
** '''n''' - default, when no switches are used. Accepts text consisting of digits only
 
** '''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.
 
* '''[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.
  
Line 26: 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 character are digit
+
will return '''$false''' because not all the characters are digits
  
  
Line 39: Line 37:
 
== See also ==
 
== See also ==
 
* {{mIRC|$calc}}
 
* {{mIRC|$calc}}
 +
* {{mIRC|$isnum}}

Latest revision as of 23:58, 16 August 2022

$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.

See also[edit]