WoW:API tonumber - Revision history

Move page script: Move page script moved page API tonumber to WoW:API tonumber without leaving a redirect

2023-08-15T04:47:37Z

Move page script moved page API tonumber to API tonumber without leaving a redirect

← Older revision	Revision as of 04:47, 15 August 2023
(No difference)

WoWWiki>Starlightblunder: /* Arguments */ --:

2010-03-25T22:59:53Z

Arguments: --:

← Older revision		Revision as of 22:59, 25 March 2010
Line 1:		Line 1:
	~~Native Lua statement:~~		{{luaapi}}
			Attempts to parse the number expressed in a string
			num = tonumber(str[, radix])

	~~;''~~Arguments''		== Arguments ==
	~~:'''tonumber(arg[, base])'''~~		; str : String/number - this value will be converted to a numeric value.
	:~~:'''arg'''~~ - this value will be converted to a numeric value.		; radix : Number - 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 may have a decimal part, as well as an optional exponent part. In other bases, only unsigned integers are accepted.
	:~~:'''base'''~~ - 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 may have a decimal part, as well as an optional exponent part. In other bases, only unsigned integers are accepted.

	~~----~~		== Returns ==
	;''~~Returns~~''		; num : Number/nil - The argument as a numeric value or '''nil''' if the value cannot be converted.

	~~:: The argument as a numeric value or '''nil''' if the value cannot be converted.~~		==Examples==
			tonumber("123") -- Returns 123

	----		tonumber("argqerg") --Returns nil
	~~;''Examples''~~

	tonumber("~~123~~")		tonumber("argqerg", 36) --Returns 4294967295
	--Returns ~~123~~

	tonumber("~~argqerg~~")		tonumber("13", 8) --Returns 11
	--Returns ~~nil~~

	~~tonumber("argqerg", 36)~~		tonumber ("D", 16) --Returns 13
	~~--Returns 4294967295~~

	~~tonumber("13", 8)~~
	~~--Returns 11~~

	tonumber ("D", 16)
	--Returns 13

	== Notes ==		== Notes ==
	* This function always converts ''arg'' into ~~base 10 (decimal)~~.		* This function always converts ''arg'' into the native number type.
	:If you want to convert from one base to another, you'll have to do the math yourself.		: If you want to convert from one base to another, you'll have to do the math yourself.
	* If ''base'' is less than 2 or greater than 36, an error will be thrown ("Base out of range").		* If ''base'' is less than 2 or greater than 36, an error will be thrown ("Base out of range").
	* If ''arg'' cannot be converted from ''base'' to decimal, nil will be returned.		* If ''arg'' cannot be converted from ''base'' to decimal, nil will be returned.

	~~{{LUA}}~~

WoWWiki>Egingell: Proper notation for optional argument. Added notes.

2009-09-23T05:54:03Z

Proper notation for optional argument. Added notes.

← Older revision		Revision as of 05:54, 23 September 2009
Line 1:		Line 1:

	Native Lua statement:		Native Lua statement:

	;''Arguments''		;''Arguments''
	:'''tonumber(arg {,base})'''		:'''tonumber(arg[, base])'''
	::'''arg''' - this value will be converted to a numeric value.		::'''arg''' - this value will be converted to a numeric value.
	::'''base''' - 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 may have a decimal part, as well as an optional exponent part. In other bases, only unsigned integers are accepted.		::'''base''' - 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 may have a decimal part, as well as an optional exponent part. In other bases, only unsigned integers are accepted.
Line 20:		Line 19:
	tonumber("argqerg")		tonumber("argqerg")
	--Returns nil		--Returns nil

			tonumber("argqerg", 36)
			--Returns 4294967295

	tonumber("13", 8)		tonumber("13", 8)
Line 26:		Line 28:
	tonumber ("D", 16)		tonumber ("D", 16)
	--Returns 13		--Returns 13

			== Notes ==
			* This function always converts ''arg'' into base 10 (decimal).
			:If you want to convert from one base to another, you'll have to do the math yourself.
			* If ''base'' is less than 2 or greater than 36, an error will be thrown ("Base out of range").
			* If ''arg'' cannot be converted from ''base'' to decimal, nil will be returned.

	{{LUA}}		{{LUA}}

WoWWiki>WoWWiki-Jebr: remove signature

2007-02-10T08:11:51Z

remove signature

← Older revision		Revision as of 08:11, 10 February 2007
Line 1:		Line 1:
	~~<center>'''tonumber()''' ''-Documentation by [[user:Two\|Two]], updated by-''</center>~~
	~~----~~

	Native Lua statement:		Native Lua statement:

WoWWiki>VoidvectorBot: Remove singatures made using ~ in main namespace

2007-02-10T06:22:49Z

Remove singatures made using ~ in main namespace

← Older revision		Revision as of 06:22, 10 February 2007
Line 1:		Line 1:
	<center>'''tonumber()''' ''-Documentation by [[user:Two\|Two]], updated by ~~[[User:Drundia\|Drundia]] 21:59, 25 April 2006 (EDT)~~-''</center>		<center>'''tonumber()''' ''-Documentation by [[user:Two\|Two]], updated by-''</center>
	----		----

Line 5:		Line 5:

	;''Arguments''		;''Arguments''
	:~~<b>~~tonumber(arg {,base})~~</b>~~		:'''tonumber(arg {,base})'''
	::~~<b>~~arg~~</b>~~ - this value will be converted to a numeric value.		::'''arg''' - this value will be converted to a numeric value.
	::~~<b>~~base~~</b>~~ - 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 may have a decimal part, as well as an optional exponent part. In other bases, only unsigned integers are accepted.		::'''base''' - 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 may have a decimal part, as well as an optional exponent part. In other bases, only unsigned integers are accepted.

	----		----
	;''Returns''		;''Returns''

	:: The argument as a numeric value or ~~<b>~~nil~~</b>~~ if the value cannot be converted.		:: The argument as a numeric value or '''nil''' if the value cannot be converted.

	----		----

WoWWiki>Mikk: Change category from "LUA Functions" to "Lua functions".

2006-05-26T12:16:31Z

Change category from "LUA Functions" to "Lua functions".

← Older revision		Revision as of 12:16, 26 May 2006
Line 1:		Line 1:
	<center>'''tonumber()''' ''-Documentation by [[user:Two\|Two]], updated by [[User:Drundia\|Drundia]] 21:59, 25 April 2006 (EDT)-''</center>		<center>'''tonumber()''' ''-Documentation by [[user:Two\|Two]], updated by [[User:Drundia\|Drundia]] 21:59, 25 April 2006 (EDT)-''</center>
	----		----

			Native Lua statement:

	;''Arguments''		;''Arguments''
	:<b>tonumber(arg {,base})</b>		:<b>tonumber(arg {,base})</b>
Line 26:		Line 29:
	--Returns 13		--Returns 13

	~~----~~		{{LUA}}
	{{~~WoW API~~}}

WoWWiki>Drundia: Added "base" argument

2006-04-26T01:59:22Z

Added "base" argument

← Older revision		Revision as of 01:59, 26 April 2006
Line 1:		Line 1:
	<center>'''tonumber()''' ''-Documentation by [[user:Two\|Two]]-''</center>		<center>'''tonumber()''' ''-Documentation by [[user:Two\|Two]], updated by [[User:Drundia\|Drundia]] 21:59, 25 April 2006 (EDT)-''</center>
	----		----
	;''Arguments''		;''Arguments''
	:<b>tonumber(~~text~~)</b>		:<b>tonumber(arg {,base})</b>
	::<b>~~text~~</b~~> <i>(string)</i~~> - this value will be converted to a numeric value.		::<b>arg</b> - this value will be converted to a numeric value.
			::<b>base</b> - 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 may have a decimal part, as well as an optional exponent part. In other bases, only unsigned integers are accepted.

	----		----
Line 18:		Line 19:
	tonumber("argqerg")		tonumber("argqerg")
	--Returns nil		--Returns nil

			tonumber("13", 8)
			--Returns 11

			tonumber ("D", 16)
			--Returns 13

	----		----
	{{WoW API}}		{{WoW API}}

WoWWiki>Muert at 05:57, 4 January 2006

2006-01-04T05:57:49Z

← Older revision		Revision as of 05:57, 4 January 2006
Line 18:		Line 18:
	tonumber("argqerg")		tonumber("argqerg")
	--Returns nil		--Returns nil

	----		----
	{{~~Template:~~WoW API}}		{{WoW API}}
	~~[[Category:API Functions\|tonumber]]~~
	~~[[Category:API String Functions\|tonumber]]~~

WoWWiki>WoWWiki-Two at 14:35, 28 August 2005

2005-08-28T14:35:42Z

@@ Line 1: / Line 1: @@
-x = tonumber("123") + 25
+<center>'''tonumber()''' ''-Documentation by [[user:Two|Two]]-''</center>
-the result x is 148
+----
 [[Category:API Functions|tonumber]]
 [[Category:API String Functions|tonumber]]

WoWWiki>Inglais at 19:09, 27 August 2005

2005-08-27T19:09:37Z

← Older revision		Revision as of 19:09, 27 August 2005
Line 2:		Line 2:

	the result x is 148		the result x is 148

			[[Category:API Functions\|tonumber]]
			[[Category:API String Functions\|tonumber]]