======tonumber======

''tonumber (_String [, _Base ])'' \\
Konvertiert einen String ''_String'' in eine Zahl. Der optionale Parameter ''_Base'' gibt an, zu welcher [[ https://de.wikipedia.org/wiki/Stellenwertsystem#Basis|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:
<code lua>
tonumber("101", 2) -- 5
</code>

Wird eine andere Basis angegeben, ist das Ergebnis ein anderes. Ohne angegebene Basis, also standardmäßig 10, wird einfach ''101'' zurückgegeben:
<code lua>
tonumber("101") -- 101
</code>

Zur Basis 7 ist die Zahl genau ''50'', da 7² + 1 = 50:
<code lua>
tonumber("101", 7) -- 50
</code>

Auch Zahlen in Hexadezimaldarstellung können so konvertiert werden:
<code lua>
tonumber("B12", 16) -- 2834
</code>

Tatsächlich können alle Buchstaben des Alphabets verwendet werden, sodass die Basis bis maximal ''36'' wachsen kann:
<code lua>
tonumber("XY", 36) -- 1222
</code>