Tonumber

From GiderosMobile
Revision as of 22:32, 13 May 2022 by MoKaLux (talk | contribs)

Available since: Gideros 2011.6
Class: (global)

Description

Tries to convert its argument to a number.

(number) = tonumber(e,base)

If the argument is already a number or a string convertible to a number, tonumber returns this number, otherwise returns nil.

An optional argument specifies the base to interpret the numeral. The base may be any integer between 2 and 36, inclusive:

  • in bases above 10, the letter 'A' (in either upper or lower case) represents 10, 'B' represents 11, and so forth, with 'Z' representing 35
  • in base 10 (the default), the number can have a decimal part, as well as an optional exponent part
  • in other bases, only unsigned integers are accepted

Parameters

e: (any) value to convert to number
base: (varies) the base to convert number to, default: 10 optional

Return values

Returns (number) returns the number or nil if it could not be converted