WoW:API EditBox GetNumber: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
({{widgetmethod}})
No edit summary
Line 1: Line 1:
{{widgetmethod}}
{{widgetmethod}}


<center>'''GetNumber''' ''-Documentation by DerGhulbus-''</center>
This function reads text entered into the editBox, tries to convert it into a number, and returns corresponding numerical value, or 0 if text didn't look like a number.


  number = editBox:GetNumber()
  num = editBox:GetNumber()


If a number was entered, it returns a numerical value of the number. If anything else was entered (including nil) it returns 0.
=== Arguments ===
:''none''


----
=== Returns ===
;''Arguments''


''none''
:;num: number entered in the EditBox
----
;''Returns''


:number
=== Details ===
:;number: Number - corresponding to the number entered in the EditBox
 
----
;''Details''


This function proves to be very useful when reading in numbers. While [[API EditBox GetText|GetText()]] will return a string, which you can't perform any arithmetic operations or comparison with, this function converts the TextString to a number. This will even work for all strings that are considered as well formed numerical constants in lua (so it will work for '314.16e-2' too).
This function proves to be very useful when reading in numbers. While [[API EditBox GetText|GetText()]] will return a string, which you can't perform any arithmetic operations or comparison with, this function converts the TextString to a number. This will even work for all strings that are considered as well formed numerical constants in lua (so it will work for '314.16e-2' too).


If you enter a string, or a hybrid like 'abc123def', the function returns 0.
Function will scan editbox text and return once it finds text which cannot be interpreted as part of a number. It will return number ''recognized so far'', or 0 if there were no valid digits recognized. The function will never return '''nil'''. For example (User input => Function returns):
 
* ":)" => 0
If you enter a hybrid like 12abc34 the function will ignore everything after the last valid digit (thus returning 12 in the example)
* "123punks! 42" => 123
* "-2.78" => -2.7799999713898
* "+3.15" => 0
* "222e-03" => 0.22200000286102
* "0.31415926536e+1" => 3.1415927410126
* "14e6" => 14000000
* "21,000" => 21

Revision as of 04:27, 8 September 2007

← Widget API ← EditBox < GetNumber

This function reads text entered into the editBox, tries to convert it into a number, and returns corresponding numerical value, or 0 if text didn't look like a number. 

num = editBox:GetNumber()

Arguments

none

Returns

num
number entered in the EditBox

Details

This function proves to be very useful when reading in numbers. While GetText() will return a string, which you can't perform any arithmetic operations or comparison with, this function converts the TextString to a number. This will even work for all strings that are considered as well formed numerical constants in lua (so it will work for '314.16e-2' too).

Function will scan editbox text and return once it finds text which cannot be interpreted as part of a number. It will return number recognized so far, or 0 if there were no valid digits recognized. The function will never return nil. For example (User input => Function returns):

  • ":)" => 0
  • "123punks! 42" => 123
  • "-2.78" => -2.7799999713898
  • "+3.15" => 0
  • "222e-03" => 0.22200000286102
  • "0.31415926536e+1" => 3.1415927410126
  • "14e6" => 14000000
  • "21,000" => 21
Retrieved from "https://addonstudio.org/mw/index.php?title=WoW:API_EditBox_GetNumber&oldid=9462"