Das Lua-Tutorial - 1 Grundlagen

==Das Lua-Tutorial - 1 Grundlagen == === Was ist Lua und was benötige ich? === [img='http://rail-sim.de/wiki/images/3/31/PP_LUATUT01_01_LuaEdit_3.03RC.png',right][/img] Lua ist eine Formsprache, mit der man ein Programm von außen steuern kann. Was heißt „außen“ und wie ist das gemeint? Ein Programm besitzt einen inneren Kern, der immer gleich abläuft – er ist fest verankert und damit von „innen“ gesteuert.Wir können ihn mit normalen Mitteln nicht verändern. Lässt ein Programm zu, dass es veränderbar ist,dann lässt es eine Steuerung von außen zu. Das kann mit einer Konfigurationsdatei („Bildschirmauflösung einstellen“)oder einem Script gelöst sein. Das Script sagt was der Kern erledigen soll.Und diese Scripte werden zum Beispiel mit Lua geschrieben – darum geht es hier. Um solche Scripte zu schreiben, muss man einer Formsprache exakt folgen. Das ist wie Tangotanzen auf der Showbühne: Nur das unser Tanzpartner die Tastatur ist. Die Formsprache beschreibt uns die Regeln, wie etwas zu formulieren ist, welche Möglichkeiten gegeben sind und was dadurch ausgelöst wird. Natürlich passiert es schnell, dass mal nicht alles glatt läuft. Und zum Glück gibt es Programme, die uns unterstützen, Fehler durch korrekten Text zu ersetzen. Diesen Text den wir schreiben, nennt man Quellcode. Ein Programm, das ich sehr gerne nutze und empfehle, ist [url='http://luaforge.net/frs/?group_id=84&release_id=553']LuaEdit 3.03RC[/url]. Es ist einfach organisiert und ermöglicht eine schnelle Überprüfung der Formsprache. So sieht das Programm aus, wenn man Scripte schreibt (siehe rechts). Die Entwicklungsumgebung [url='http://luaforge.net/frs/?group_id=84&release_id=553']LuaEdit 3.03RC[/url] Oben haben wir ein Menü. Es ermöglicht allgemeine Operationen, Sichteinstellungen, Projektverwaltung, einen Test durchzuführen und das starten von Tools. In der oberen Toolleiste finden wir in der ersten Gruppe Felder zum erzeugen neuer Dateien oder Projekte.In der zweiten Gruppe können wir Dateien öffnen und speichern. In der dritten Gruppe können wirDateien zu Projekten zuordnen. Die vierte Gruppe ermöglicht das Drucken. Die fünfte Gruppe kannden Testdurchlauf beeinflussen. Die sechste Gruppe ermöglicht das Prüfen der Syntax unddas Erstellen von kompilierten Scripten. Die siebente Gruppe ermöglicht das Suchen unddas Setzen von Haltepunkten im Script, wenn wir einen Testdurchlauf durchführen. Die untere Toolleiste vereinfacht das Bearbeiten von Text. Dazu zählt zum Beispieldas automatische Ein- und Auskommentieren oder Verrücken von Text.Am besten probiert man an einem Testtext, was der jeweiligen Schalter bewirkt :-). Ich habe bei der Beschreibung das Wort „Kompilieren“ in den Raum geworfen.Das ganze muss man sich so vorstellen: Wir schreiben Text in lesbarer Form,den wir verändern können. Kompilieren wir den Text, wird unser geschriebenesinterpretiert und mit programmeigenen Anweisungen übersetzt. Die programmeigenenAnweisungen können wir natürlich nicht ohne weiteres frei bearbeiten.Das ganze macht man, damit man Zeit spart, weil die Interpretation manchmalganz schön lange dauern kann, wenn man sehr viele Scriptdateien hat.Aber damit müssen wir uns in RailWorks nicht herumärgern: Das macht RailWorks für uns, leider. === Kommentieren hilft === Scripten ist eine Gemeinschaftsaufgabe. Schreiben wir Quellcode, müssen wir später verstehen,was wir geschrieben haben. Und unseren Mitgliedern hilft es, Fehler schneller und leichter zu entlarven,um sie auszumerzen. Ein Kommentar ist dabei etwas, was nicht vom Interpreter (dem „Leser“) beachtet wird. Er wird mit zwei arabischen Zahlstrichen angefangen (--) und gilt für die eine Zeile. Etwa so: [color=#008000]-- Kommentare sind für folgende Fälle gedacht:[/color] [list][*][b]Hinweise am Anfang der Dateien[/b] [list][*]wer, was, wann und wie etwas geändert hat. [*]Falls notwendig: Nenne [list][*]die verwendete Sprache [*]den Namen der Gruppe [*]oder die Lizenz (und/oder deren Bedingungen). [/list][/list][*][b]Eigenschaften der Funktionen[/b] [list][*]Was sie machen sollen oder bewirken [*]Wann sie verwendet werden dürfen [*]Welche Parameter zulässig sind und was sie bedeuten – die Einheiten [*]Rückgabewerte, wenn Sie vorhanden sind [/list][*][b]Beschreibung der Aufgabenfelder[/b] [list][*]was wie erledigt werden soll [*]welche Werte warum besondere Rollen spielen. [/list][/list]Es ist ein logischer Prozess und wird eine Menge Schreibarbeit verursachen. Aber das Tutorial ist so ausgelegt, dass die „Kommunikationsaufgabe Kommentieren“ als Routine ein leichtes Spiel wird. === Variablen und Werte === Informationen müssen gespeichert werden: Dieser Aufgabe werden Variablen gerecht. Ihre Werte werden durch logische Berechnungsprozesse oder festgelegte Logik bestimmt. Damit man unterscheiden kann, was Werte beinhalten, unterteilt man diese in Dateitypen. Für uns wichtig kann sein: Datentyp Beschreibung Beispiel [table] [tr] [td]string[/td] [td]Ein Text aus einer Verkettung von Zeichen.[/td] [td]„Hallo Welt“[/td] [/tr] [tr] [td]number[/td] [td]Eine Zahl. Bei Gleitkommazahlen schreibt man mit Punkt statt mit Komma. Ein „f“ kann zusätzlich stehen und hat für uns keine Bedeutung.[/td] [td]3, 5, 9 2.6, 3.1415f[/td] [/tr] [tr] [td]Boolean[/td] [td]Ein Wahrheitswert. Wahr oder Falsch.[/td] [td]Wert: true oder false[/td] [/tr] [tr] [td]nil[/td] [td]Eine Variable, die keinen Wert hat: Datentyplos.[/td] [td]Wert: nil[/td] [/tr] [tr] [td]table[/td] [td]Eine Tabelle: „Array“.[/td] [td]Definition: { }[/td] [/tr] [/table] Der Datentyp wird zur Laufzeit gewählt und ist bei vielen Typen austauschbar. So kann ein string zum Beispiel zu einer Zahl umgewandelt werden, wenn dies möglich ist. Ein Wahrheitswert, eine Zahl oder auch nil kann zu einem Text umgewandelt werden. Die Definition einer Variable ist einfach – man schreibt sie in folgender Form auf: [Name] = [Wert] Dazu ein paar Beispiele: [img]http://rail-sim.de/wiki/images/1/16/PP_LUATUT01_02_Variablendefinitionen.png[/img] Ganz links ist die Zeilennummer, Einzustellen in den Optionen von LuaEdit.Die Namensgebung von Variablen entspricht den obigen Beispielen: Sie darf mit einem Buchstaben anfangen, der keine Nummer ist. Nach dem ersten Buchstaben darf man Nummern verwenden – das meidet man allerdings. === Operatoren === Beim Programmieren unterscheidet man in drei Arten von Operationen: [list][*]Arithmetische Operationen (Rechenoperationen) [*]Relationale Operationen (Vergleichsoperationen) und [*]Logische Operationen [/list]Jede Gruppe deckt bestimmte Aufgabenfelder ab. So dienen arithmetische Operationen der Berechnung von Werten und relationale und logische Operationen dem Vergleich von Werten. Dieser Abschnitt beschäftigt sich mit Rechenoperationen. Das sind die Operatoren [list][*]"=" --> Zuweisungsoperator [*]"+" --> Additionsoparator [*]"-" --> Subtraktionsoperator oder auch Negationsoperator [*]"*" --> Multiplikationsoperator [*]"/" --> Divisionsoperator [*]".." --> Verknüpfungsoperator [/list]Um diese Funktion zu verdeutlichen, dienen folgende Beispiele: [img]http://rail-sim.de/wiki/images/b/be/PP_LUATUT01_03_ArOperationen.png[/img] === Kontrollstrukturen und Schleifen=== ==== Anweisungen und Rümpfe ==== Jede Anweisung wird in einem Rumpf ausgeführt. Dabei unterscheidet man in [list][*]Anweisungsrümpfe [*]Branchrümpfe [*]Branchrümpfe der If-Else-Kontrollstrukturen [/list]Branchrümpfe begrenzen einen Programmblock und benötigen eine Bedingung: [tt](Bedingung) then[/tt] [tt](Anweisung)[/tt] [tt]]end[/tt] Sie werden mit then eingeleitet und mit end beendet. Anweisungsrümpfe der If-Else-Kontrollstrukturen werden wie Anweisungsrümpfe definiert, können jedoch ohne das Schlüsselwort end beendet werden, wenn sie mit elseif oder else beendet werden. [tt]if (Bedingung) then[/tt] [tt](Anweisung)[/tt] [tt]elseif (Bedingung) ...[/tt] Anweisungen wie a = 2 können mit einem Semikolon angeschlossen werden, wie es in anderen Programmiersprachen üblich ist: a = 2; ==== Wenn-Kontrollstrukturen ==== Im vorigen Abschnitt wurden logische Operatoren genannt – diese sind Bestandteil der Kontrollstrukturen und Schleifen. Unter Kontrollstrukturen kann man sich einfache Wenn-Verzweigungen vorstellen. Schleifen werden hingegen solange ausgeführt, wie die Bedingung zutrifft. Eine Verzweigung wird mit einer if-Bedingung realisiert: [tt]if (Bedingung) then[/tt] [tt](Anweisungen)[/tt] [tt]end[[/tt] Die Bedingungen werden mit Operatoren geprüft oder verknüpft. Die Vergleichsoperationen sind: [table] [tr] [td]Operator[/td] [td]Bedeutung[/td] [td]Beispiel[/td] [/tr] [tr] [td]==[/td] [td]Gleichheitsoperator. Wahr wenn beide Werte gleich sind.[/td] [td]5 == 5 --> Wahr[/td] [/tr] [tr] [td]~=[/td] [td]Ungleichheitsoperator. Wahr wenn beide Werte nicht gleich sind.[/td] [td]5 ~= 5 --> Falsch[/td] [/tr] [tr] [td] Wahr[/td] [/tr] [tr] [td] Wahr[/td] [/tr] [tr] [td]>[/td] [td]Größer-als-Operator. Wahr wenn der zu prüfende Wert größer ist als der andere.[/td] [td]6 > 5 --> Wahr[/td] [/tr] [tr] [td]>=[/td] [td]Größer-als-oder-gleich-Operator. Wahr wenn der zu prüfende Wert größer oder gleich dem Anderen ist.[/td] [td]5 >= 5 --> Wahr[/td] [/tr] [/table] Vergleichsoperationen können verknüpft werden. Dazu dienen folgende Vergleichsoperationen: [table] [tr] [td]Operator[/td] [td]Bedeutung[/td] [td]Beispiel[/td] [/tr] [tr] [td]and[/td] [td]Und-Operator. Gibt wahr zurück, wenn beide Operanden wahr sind.[/td] [td]true and true --> Wahr true and false --> Falsch[/td] [/tr] [tr] [td]or[/td] [td]Oder-Operator. Gibt wahr zurück, wenn ein Operand wahr ist.[/td] [td]false or false --> Falsch true or false --> Wahr[/td] [/tr] [tr] [td]not[/td] [td]Wahrheits-Negations-Operator. Mach ein Wahr zu Falsch und ein Falsch zu wahr.[/td] [td]not true wird zu false not false wird zu true[/td] [/tr] [/table] Zusatzbemerkung: not ist vorrangig zu den arithmetischen Operatoren. Logikoperationen zu Vergleichsoperationen. Arithmetische Operationen vorrangig zu Logikoperationen. Zu Wahrheitswerten ist kein Vergleichsoperator notwendig – er wird immer gegen true geprüft. Oftmals ist es notwendig, weitere Fall-Abzweige zu programmieren. Vom Prinzip: wenn das… oder wenn das… oder das. Dies wird wird else-if-Kontrollstrukturen realisiert. Der Aufbau dieser Kontrollstrukturen ist der Folgende: [tt]if (Bedingung) then[/tt] [tt](Anweisungsblock den Fall)[/tt] [tt]else[/tt] [tt](Anweisungsblock für unbehandelte Fälle)[/tt] [tt]end[/tt] [tt]if (Bedingung A) then[/tt] [tt](Anweisungsblock für Fall A)[/tt] [tt]elseif (Bedingung B) then[/tt] [tt](Anweisungsblock für Fall B)[/tt] [tt](optional: else[/tt] [tt](Anweisungsblock für unbehandelte Fälle))[/tt] [tt]end[/tt] Um das ganze System zu verdeutlichen, dienen folgende Beispiele: [img]http://rail-sim.de/wiki/images/9/9f/PP_LUATUT01_06_Vergleiche.png[/img] ==== Schleifen ==== Schleifen dienen zur Wiederholung einer Anweisung, solange eine bestimmte Bedingung gültig ist. Die einfachste Schleife ihrer Art ist die while-Schleife. Solange die Bedingung gültig ist, wird deren Anweisung im then-end-Block ausgeführt: [tt]while (Bedingung) do[/tt] [tt](Anweisung)[/tt] [tt]end[/tt] Das Folgende Beispiel lässt den Wert c solange herunterzählen, bis c Null ist: [img]http://rail-sim.de/wiki/images/7/79/PP_LUATUT01_07_While-Schleife.png[/img] Dekrementieren = Zahl um 1 verringern. Inkrementieren = Zahl um 1 erhöhen. Manchmal ist es Notwendig, dass der Anweisungsblock vor der Bedingungsprüfung notwendig ist. Dazu dienen repeat-until-Schleifen – auch bekannt als do-while-Schleife. [tt]repeat[/tt] [tt](Anweisungen)[/tt] [tt]until (Bedingung)[/tt][font='Consolas,Courier New,Courier,monospace'][/font] [img]http://rail-sim.de/wiki/images/6/64/PP_LUATUT01_09_Repeat-Until-Schleife.png[/img] Eine weitere interessante Schleife ist die numerische for-Schleife. In ihr ist die Deklaration, Zielwert und Schrittweite definiert. Folgende Form ist dabei zu beachten: [tt]for (Deklaration), (Zielwert)(optional:,(Schrittweite)) do[/tt] [tt](Anweisung)[/tt] [tt]end[/tt] Ist die Schrittweite nicht definiert (weil optional), wird 1 als Standardwert verwendet. Das folgende Beispiel berechnet c von 0 bis 10 als Folge: [img]http://rail-sim.de/wiki/images/1/1e/PP_LUATUT01_08_For-Schleife.png[/img] === Funktionen === Funktionen werden wie folgt aufgerufen: [tt]Funktionsname ( Argument, Argument, ... )[/tt] Beispiel: [tt]SendSignalMessage(PZB_500, ““, 1, 1, linkIndex)[/tt] Möchte man eigene Funktionen programmieren, verwendet man folgende Form: [tt]function Funktionsname(Parameter, Parameter, ...)[/tt] [tt](Anweisungen)[/tt] [tt]end[/tt] Es sei noch zu erwähnen, dass man an Funktionen Argumente (Werte) übergibt und bei der Definition Parameter definiert. Folglich nennt man die übergebenen Argumente innerhalb einer Funktion Argument. Das folgende Beispiel zeigt die Deklaration der Funktion DebugMessage() und deren Aufruf. [img]http://rail-sim.de/wiki/images/d/dd/PP_LUATUT01_10_Funktionen.png[/img] Möchte man Rückgabewerte zurückgeben, wird dies mit dem Schlüsselwort [tt]return [/tt] eingeleitet. In Lua ist es möglich mehrere Rückgabewerte zurückzuliefern. Das folgende Beispiel zeigt, wie das geht: [img]http://rail-sim.de/wiki/images/e/e7/PP_LUATUT01_11_R%C3%BCckgabewerte.png[/img] === Tabellen === Fast geschafft. Im letzten „Lernkapitel“ werden Tabellen behandelt. Tabellen werden auch als Arrays bezeichnet. Sie beinhalten Daten in Form von Schlüssel-Wert-Paaren. Eine Tabelle wird wie folgend deklariert: [tt]Variable = {}[/tt] Es ist ebenfalls möglich, zur Deklaration Werte in Tabellen schreiben: [tt]Variable = { VariablenName = Wert, ... }[/tt] Der Zugriff ist vielseitig. Entweder greift man über eckige Klammern auf ein Schlüssel-Wert-Paar zu. Der Zugriff funktioniert auch über ein Tabelle-Punkt-Variablenname-System: [img]http://rail-sim.de/wiki/images/b/b0/PP_LUATUT01_12_Tabellen.png[/img] Eine weitere Schleifenart ist die generische for-Schleife. Sie wird für Tabellen benutzt. Um sie zu realisieren benutzt man die Funktion [tt]inpairs(Tabelle)[/tt]. Das folgende Beispiel zeigt die Syntax: [img]http://rail-sim.de/wiki/images/2/2a/PP_LUATUT01_13_For-Generisch.png[/img] == Ein paar Hinweise == Dieser Artikel gab einen Einblick in Lua und hat Grundlagen der Sprache vorgestellt. Nun beherrscht man die Sprache Lua im Allgemeinen. Doch was würde man ohne die Standardbibliotheken machen? Es gibt vorgefertigte Funktionen, zum Beispiel eine Mathematikbibliothek. Zudem wurde noch nicht auf Besonderheiten bezüglich RailWorks eingegangen. Dies folgt in den Artikeln: [url='http://rail-sim.de/wiki/index.php/Das_Lua-Tutorial_-_2_Tipps_und_Bibliotheken']Das Lua-Tutorial: #2 – Die Lua-Bibliotheken[/url] [url='http://rail-sim.de/wiki/index.php?title=Das_Lua-Tutorial_-_3_RailWorks:_Besonderheiten_und_Funktions%C3%BCbersucht&action=edit&redlink=1']Das Lua-Tutorial: #3 – Besonderheiten und Funktionsübersucht[/url]