Lua 5.3 - README blockquote, .display { border: solid #a0a0a0 2px ; border-radius: 8px ; padding: 1em ; margin: 0px ; } .display { word-spacing: 0.25em ; }

dl.display dd { padding-bottom: 0.2em ; }

tt, kbd, code { font-size: 12pt ; }

Willkommen bei Lua 5.3

Über Lua

Lua ist eine leistungsstarke, schnelle, leichtgewichtige, einbettbare Skriptsprache, die von einem Team an der PUC-Rio, der Päpstlichen Katholischen Universität von Rio de Janeiro in Brasilien, entwickelt wird. Lua ist freie Software und wird weltweit in vielen Produkten und Projekten eingesetzt.

Die offizielle Webseite von Lua bietet vollständige Informationen über Lua, darunter eine Kurzfassung und aktualisierte Dokumentation, insbesondere das Referenzhandbuch, das geringfügig von der lokalen Kopie abweichen kann, die in diesem Paket enthalten ist.

Installation von Lua

Lua wird im Quellcode verteilt. Sie müssen es vor der Verwendung kompilieren. Das Kompilieren von Lua sollte unkompliziert sein, da Lua in reinem ANSI-C implementiert ist und auf allen bekannten Plattformen mit einem ANSI-C-Compiler unverändert kompiliert wird. Lua lässt sich auch unverändert als C++ kompilieren. Die folgenden Anweisungen zum Kompilieren von Lua gelten für Unix-ähnliche Plattformen. Siehe auch Anleitungen für andere Systeme und Anpassungsmöglichkeiten.

Wenn Sie keine Zeit oder Lust haben, Lua selbst zu kompilieren, holen Sie sich ein Binärpaket von LuaBinaries. Probieren Sie auch LuaDist, eine plattformübergreifende Distribution von Lua, die zusätzliche Pakete enthält.

Lua erstellen

Auf den meisten Unix-ähnlichen Plattformen genügt der Befehl "make" mit einem geeigneten Ziel. Hier die Details.

1. Öffnen Sie ein Terminal-Fenster und wechseln Sie in das oberste Verzeichnis mit dem Namen lua-5.3.5. Die dortige Makefile steuert sowohl den Build- als auch den Installationsprozess.

2. Führen Sie "make" aus und prüfen Sie, ob Ihre Plattform aufgelistet ist. Die derzeit unterstützten Plattformen sind:

   aix bsd c89 freebsd generic linux macosx mingw posix solaris

   Wenn Ihre Plattform aufgelistet ist, führen Sie einfach "make xxx" aus, wobei xxx der Name Ihrer Plattform ist.

   Wenn Ihre Plattform nicht aufgelistet ist, versuchen Sie in dieser Reihenfolge die nächstgelegene oder posix, generic, c89.

3. Die Kompilierung dauert nur wenige Augenblicke und erzeugt drei Dateien im Verzeichnis src: lua (der Interpreter), luac (der Compiler) und liblua.a (die Bibliothek).

4. Um zu überprüfen, ob Lua korrekt erstellt wurde, führen Sie nach dem Build "make test" aus. Dies startet den Interpreter und gibt seine Version aus.

Wenn Sie Linux verwenden und Kompilierungsfehler auftreten, stellen Sie sicher, dass Sie das Entwicklungspaket readline installiert haben (wahrscheinlich libreadline-dev oder readline-devel). Wenn danach Linkfehler auftreten, versuchen Sie "make linux MYLIBS=-ltermcap".

Lua installieren

Sobald Sie Lua erstellt haben, möchten Sie es möglicherweise an einem offiziellen Ort in Ihrem System installieren. Führen Sie in diesem Fall "make install" aus. Der offizielle Ort und die Art der Installation der Dateien sind in der Makefile festgelegt. Sie benötigen wahrscheinlich die entsprechenden Berechtigungen, um Dateien zu installieren.

Um Lua in einem Schritt zu erstellen und zu installieren, führen Sie "make xxx install" aus, wobei xxx der Name Ihrer Plattform ist.

Um Lua lokal zu installieren, führen Sie "make local" aus. Dies erzeugt ein Verzeichnis install mit den Unterverzeichnissen bin, include, lib, man, share und installiert Lua wie unten aufgeführt.

Um Lua lokal, aber in einem anderen Verzeichnis zu installieren, führen Sie "make install INSTALL_TOP=xxx" aus, wobei xxx Ihr gewähltes Verzeichnis ist. Die Installation beginnt in den Verzeichnissen src und doc, seien Sie also vorsichtig, wenn INSTALL_TOP kein absoluter Pfad ist.

bin:

lua luac

include:

lua.h luaconf.h lualib.h lauxlib.h lua.hpp

lib:

liblua.a

man/man1:

lua.1 luac.1

Dies sind die einzigen Verzeichnisse, die Sie für die Entwicklung benötigen. Wenn Sie nur Lua-Programme ausführen möchten, benötigen Sie nur die Dateien in bin und man. Die Dateien in include und lib werden benötigt, um Lua in C- oder C++-Programme einzubetten.

Anpassung

Drei Arten von Dingen können durch Bearbeiten einer Datei angepasst werden:

• Wo und wie Lua installiert wird — bearbeiten Sie Makefile.
• Wie Lua erstellt wird — bearbeiten Sie src/Makefile.
• Lua-Funktionen — bearbeiten Sie src/luaconf.h.

Sie müssen die Makefiles nicht unbedingt bearbeiten, da Sie die relevanten Variablen in der Befehlszeile beim Aufruf von make setzen können. Dennoch ist es wahrscheinlich am besten, die Makefiles zu bearbeiten und zu speichern, um die von Ihnen vorgenommenen Änderungen festzuhalten.

Wenn Sie hingegen einige Lua-Funktionen anpassen müssen, müssen Sie src/luaconf.h vor dem Erstellen und Installieren von Lua bearbeiten. Die bearbeitete Datei wird installiert und von allen von Ihnen erstellten Lua-Clients verwendet, um Konsistenz zu gewährleisten. Experten können durch Bearbeiten der Lua-Quellen weitere Anpassungen vornehmen.

Lua auf anderen Systemen erstellen

Wenn Sie nicht die üblichen Unix-Werkzeuge verwenden, hängen die Anweisungen zum Erstellen von Lua von dem von Ihnen verwendeten Compiler ab. Sie müssen Projekte (oder was auch immer Ihr Compiler verwendet) zum Erstellen der Bibliothek, des Interpreters und des Compilers erstellen, wie folgt: