| Beide Seiten, vorherige ÜberarbeitungVorherige ÜberarbeitungNächste Überarbeitung | Vorherige Überarbeitung |
| scripting:reference:standard_library:base [2023/11/24 11:48] – fritz_98 | scripting:reference:standard_library:base [2024/05/13 08:00] (aktuell) – fritz_98 |
|---|
| ^Funktion^Beschreibung^ | ^Funktion^Beschreibung^ |
| | [[ scripting:reference:standard_library:base:assert |assert (_Condition [, _Message ])]] | Prüft die Bedingung ''_Condition'' und zeigt eine Fehlermeldung an, falls sie nicht zutrifft. Außerdem wird die Ausführung der Funktion an der Stelle, an der ''_Condition'' nicht zutrifft, abgebrochen. In der Fehlermeldung wird der optionale Parameter ''_Message'' angezeigt. Diese Funktion wird in der Regel dafür benutzt, um angegebene Parameter auf Gültigkeit zu prüfen. | | | [[ scripting:reference:standard_library:base:assert |assert (_Condition [, _Message ])]] | Prüft die Bedingung ''_Condition'' und zeigt eine Fehlermeldung an, falls sie nicht zutrifft. Außerdem wird die Ausführung der Funktion an der Stelle, an der ''_Condition'' nicht zutrifft, abgebrochen. In der Fehlermeldung wird der optionale Parameter ''_Message'' angezeigt. Diese Funktion wird in der Regel dafür benutzt, um angegebene Parameter auf Gültigkeit zu prüfen. | |
| | [[ scripting:reference:standard_library:base:ipairs |ipairs (_Table)]] | Gibt für ein **[[ scripting:tutorials:level1:tables#tables_als_listen |numerisches Table]]** ''_Table'' einen Iterator (FIXME link) zurück, der in pro Iteration einen Index und zugehörigen Wert im Table generiert, wobei der Index von 1 bis //n// läuft. Beispiele siehe auch [[ scripting:tutorials:level2:loops#ipairs |hier]] | | | [[ scripting:reference:standard_library:base:ipairs |ipairs (_Table)]] | Gibt für ein **[[ scripting:tutorials:level1:tables#tables_als_listen |numerisches Table]]** ''_Table'' einen Iterator (FIXME link) zurück, der in pro Iteration einen Index und zugehörigen Wert im Table generiert, wobei der Index von 1 bis //n// läuft. Die Iteration stoppt, sobald ein Index-Wert nicht mehr auf den vorigen folgt. Nicht-numerische Keys werden ignoriert | |
| | [[ scripting:reference:standard_library:base:next |next (_Table [, _Index ])]] | Gibt für ein Table ''_Table'' das nächste Key-Value-Paar des Tables, abhängig von ''_Index'' zurück. Ist ''_Index'' nicht angegeben, wird das erste Key-Value-Paar zurückgegeben. Ist ''_Table'' leer oder das letzte Element erreicht, wird **nil** zurückgegeben. Die Reihenfolge, in der die Key-Value-Paare des Tables zurückgegeben werden, ist undefiniert und kann jedes mal unterschiedlich sein | | | [[ scripting:reference:standard_library:base:next |next (_Table [, _Key ])]] | Gibt für ein Table ''_Table'' das nächste Key-Value-Paar des Tables, abhängig von ''_Key'' zurück. Ist ''_Key'' nicht angegeben, wird ein beliebiges Key-Value-Paar zurückgegeben. Ist ''_Table'' leer oder das letzte Element erreicht, wird **nil** zurückgegeben. Die Reihenfolge, in der die Key-Value-Paare des Tables zurückgegeben werden, ist undefiniert und kann jedes mal unterschiedlich sein | |
| | [[ scripting:reference:standard_library:base:pairs |pairs (_Table)]] | Gibt für ein Table ''_Table'' einen Iterator (FIXME link) zurück, der in pro Iteration ein Key-Value-Paar im Table generiert, deren Reihenfolge undefiniert ist und jedes mal unterschiedlich sein kann. Beispiele siehe auch [[ scripting:tutorials:level2:loops#pairs |hier]] | | | [[ scripting:reference:standard_library:base:pairs |pairs (_Table)]] | Gibt für ein Table ''_Table'' einen Iterator (FIXME link) zurück, der in pro Iteration ein Key-Value-Paar im Table generiert, deren Reihenfolge undefiniert ist und jedes mal unterschiedlich sein kann | |
| | [[ scripting:reference:standard_library:base: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 | | | [[ scripting:reference:standard_library:base: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 | |
| | [[ scripting:reference:standard_library:base:tostring |tostring (_Value)]] | Versucht, den Wert ''_Value'' in einen String umzuwandeln. Funktioniert nicht für Tables und Funktionen | | | [[ scripting:reference:standard_library:base:tostring |tostring (_Value)]] | Wandelt den Wert ''_Value'' in einen String um. Praktisch nur für Zahlen und Booleans sinnvoll | |
| | [[ scripting:reference:standard_library:base:type |type (_Value)]] | Gibt den Datentyp von ''_Value'' als String zurück | | | [[ scripting:reference:standard_library:base:type |type (_Value)]] | Gibt den Datentyp von ''_Value'' als String zurück | |
| | [[ scripting:reference:standard_library:base:unpack |unpack (_Table)]] | Gibt für ein **[[ scripting:tutorials:level1:tables#tables_als_listen |numerisches Table]]** ''_Table'' alle Werte (einzeln) zurück | | | [[ scripting:reference:standard_library:base:unpack |unpack (_Table)]] | Gibt für ein **[[ scripting:tutorials:level1:tables#tables_als_listen |numerisches Table]]** ''_Table'' alle Werte (einzeln) zurück | |
| |
| |
| |
| FIXME folgende Funktionen mit aufnehmen? Sie sind ja verfügbar, nur nicht wirklich nützlich: ''collectgarbage'', ''getmetatable'', ''pcall'', ''setmetatable'' | |
| |
