Difference between revisions of "Tonumber"
From GiderosMobile
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
| − | + | '''Available since:''' Gideros 2011.6<br/> | |
| − | ''' | + | '''Class:''' [[(global)]]<br/> |
| − | ''' | ||
| − | === | + | === Description === |
| − | + | Tries to convert its argument to a number. | |
| − | |||
| − | |||
<source lang="lua"> | <source lang="lua"> | ||
(number) = tonumber(e,base) | (number) = tonumber(e,base) | ||
</source> | </source> | ||
| − | === | + | If the argument is already a number or a string convertible to a number, ''tonumber'' returns this number, otherwise returns nil. |
| − | '''e''': (any) | + | |
| − | '''base''': (varies) | + | 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<br/> | ||
| + | '''base''': (varies) the base to convert number to, default: 10 '''optional'''<br/> | ||
| − | === | + | === Return values === |
| − | ''' | + | '''Returns''' (number) returns the number or nil if it could not be converted<br/> |
{{(global)}} | {{(global)}} | ||
Revision as of 22:32, 13 May 2022
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
