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, leichte, eingebettbare Skriptsprache, die von einem Team an der PUC-Rio, der Pontifícia Universidade Católica do Rio de Janeiro in Brasilien, entwickelt wurde. Lua ist freie Software, die in vielen Produkten und Projekten weltweit eingesetzt wird.

Die offizielle Website von Lua bietet vollständige Informationen über Lua, einschließlich einer Zusammenfassung und aktualisierter Dokumentation, insbesondere das Referenzhandbuch, das geringfügig von der lokalen Kopie abweichen kann, die in diesem Paket enthalten ist.

Lua installieren

Lua wird in Quellcode-Form verteilt. Sie müssen es kompilieren, bevor Sie es verwenden können. 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 unten angegebenen Anweisungen zum Kompilieren von Lua gelten für Unix-ähnliche Plattformen. Siehe auch Anweisungen für andere Systeme und Anpassungsoptionen.

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

Lua kompilieren

Auf den meisten Unix-ähnlichen Plattformen führen Sie einfach "make" mit einem passenden Ziel aus. Hier sind die Details.

1. Öffnen Sie ein Terminalfenster und wechseln Sie in das oberste Verzeichnis, das lua-5.3.5 heißt. Die Makefile dort steuert sowohl den Kompilierungs- 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 die nächstgelegene oder posix, generic, c89, in dieser Reihenfolge.

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 kompiliert wurde, führen Sie "make test" nach dem Kompilieren von Lua aus. Dies startet den Interpreter und gibt seine Version aus.

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

Lua installieren

Sobald Sie Lua kompiliert haben, möchten Sie es vielleicht 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 definiert. Sie benötigen wahrscheinlich die entsprechenden Berechtigungen, um Dateien zu installieren.

Um Lua in einem Schritt zu kompilieren 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 erstellt 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 die Makefile.
• Wie Lua kompiliert 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 Kompilieren und Installieren von Lua bearbeiten. Die bearbeitete Datei wird installiert, und sie wird von allen Lua-Clients verwendet, die Sie kompilieren, um Konsistenz zu gewährleisten. Experten stehen weitere Anpassungsmöglichkeiten durch Bearbeiten der Lua-Quellen zur Verfügung.

Lua auf anderen Systemen kompilieren

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