Revision as of 17:28, 17 February 2022

$isnumber Returns $true if text is a number, otherwise returns $false.

Note: switches affects the range number parameters, see the examples

Synopsis

$isnumber(text,[snd],[I,J])

Parameters

• text - The input string to be checked
  
• [snd] - Switches allowing for number to be preceded by +- sign and accepting floats
  • s - also permits +- sign to be used
  • 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.

Properties

None

Example

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

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

• $calc