tonumber

tonumber (_String [, _Base ])
Konvertiert einen String _String in eine Zahl. Der optionale Parameter _Base gibt an, zu welcher Basis die Zahl im String interpretiert werden soll. Kann _String nicht zu einer Zahl umgewandelt werden, wird nil zurückgegeben.

Parameter

Name	Typ	Beschreibung
_String	String	String, der zu einer Zahl konvertiert werden soll
_Base	Zahl	Optionaler Parameter; Basis der Zahl, zu welcher die Zahl in `_String` interpretiert werden soll. Wenn nicht angegeben, wird von Basis 10 ausgegangen

Rückgabewerte

Name	Typ	Beschreibung
Number	Zahl	Zur Zahl konvertierter String

Beispiele

Die Zahl 5 in Binärdarstellung ist 101. Folgender Aufruf konvertiert den String „101“ zur Zahl 5:

tonumber("101", 2) -- 5

Wird eine andere Basis angegeben, ist das Ergebnis ein anderes. Ohne angegebene Basis, also standardmäßig 10, wird einfach 101 zurückgegeben:

tonumber("101") -- 101

Zur Basis 7 ist die Zahl genau 50, da 7² + 1 = 50:

tonumber("101", 7) -- 50

Auch Zahlen in Hexadezimaldarstellung können so konvertiert werden:

tonumber("B12", 16) -- 2834

Tatsächlich können alle Buchstaben des Alphabets verwendet werden, sodass die Basis bis maximal 36 wachsen kann:

tonumber("XY", 36) -- 1222