View source for Bien débuter avec le langage script Lua

== A propos de Lua ==
[http://www.lua.org/about.html Lua] est un langage script puissant, rapide et léger intégré dans MorphOS.
Il supporte également les ports de communication ARexx sur MorphOS.

== Usage ==
L'interpréteur Lua est implémenté comme une library partagée (lua.library), qui peut être utilisée en interne avec l'[http://www.lua.org/manual/5.1/manual.html#3 C API] de Lua.

Lua peut également être utilisé comme un langage autonome qui peut exécuter des scripts avec la commande [[Shell_Commands/LuaX|LuaX]] de MorphOS.

== Caractéristiques spécifiques MorphOS ==
=== Modules ===
Les librairies standard Lua sont mis en œuvre sous forme de modules partagés et, contrairement à la distribution standard de Lua, ils doivent être chargés séparément avec la fonction '''require ()''' si nécessaire.

The only module available immediately is ''package''.

Le répertoire ''MOSSYS:Libs/Lua/'' contient tous les modules disponibles. Ils sont inclus dans MorphOS 3.9:
* [http://www.lua.org/manual/5.1/manual.html#5.1 base]
* [http://www.lua.org/manual/5.1/manual.html#5.2 coroutine]
* [http://www.lua.org/manual/5.1/manual.html#5.9 debug]
* [http://lua-users.org/wiki/InteractiveLua ilua]
* [http://www.lua.org/manual/5.1/manual.html#5.7 io]
* [[Getting_Started_with_Lua#ARexx_Communication|ipc]]
* [http://www.lua.org/manual/5.1/manual.html#5.6 math]
* [http://www.lua.org/manual/5.1/manual.html#5.8 os]
* scribble
* [http://www.lua.org/manual/5.1/manual.html#5.4 string]
* [http://www.lua.org/manual/5.1/manual.html#5.5 table]

Par exemple, une ligne '''require("io")''' est nécessaire avant d'utiliser la fonction ''io.write()''.

=== Communication ARexx ===
Le module ''ipc'' contient les fonctions suivantes pour communiquer avec des programmes via leurs ports ARexx :

* ipc.'''address(port)''' - Définit le port Arexx par défaut pour transmettre des commandes. ''address("COMMAND")'' exécute des commandes comme des commandes DOS (bien que la commande Lua ''os.execute()'' fasse la même chose).
* '''ipc.checkport(port)''' - Teste si un port ARexx est disponible.
* ipc.'''rx(command)''' - Envoi une commande ARexx vers un port définit avec ipc.address. La commande ARexx RESULT retourne le résultat de la fonction. La variable Lua ''rc'' est également définit comme le résultat de rc d'Arexx.
* '''ipc.waitforport(name[, interval])''' - Attend l'ouverture d'un port publique. Le script est arrêté si le port n'est pas trouvé après l’intervalle de temps spécifiée (l'interval de temps par défaut est de 5 secondes).

Note: les fonctions address() et rx() sont enregistrées dans l'espace global Lua et devrait être appelé sans le préfixe ''ipc.''.

Exemple:
 <nowiki>
-- Charge le module dont nous avons besoin :
require("ipc")

-- Si l'un de port est trouvé, nous allons ouvrir la page officielle de MorphOS et passé en mode plein écran :
if ipc.checkport("OWB.1") then
   address("OWB.1")
   rx("OPEN NAME http://www.morphos-team.net/")
   rx("FULLSCREEN")
end</nowiki>

Si l'exemple précédent est sauvegardé dans un fichier appelé ''test.lua'', il peut être exécuté à partir du shell avec la ligne de commande ''LuaX test.lua''.

== Documentation ==
Il est facile de trouver toutes sortes de documents et de solutions pour à vos problèmes Lua sur Internet, mais voici quelques recommandations.

Documentation officielle :
* [http://www.lua.org/pil/contents.html Programming in Lua]
* [http://www.lua.org/manual/5.1/ Lua 5.1 Reference Manual]

Tutoriels réalisés par des utilisateurs de Lua :
* [http://lua-users.org/wiki/TutorialDirectory Tutorial Directory]

Autodocs et exemples MorphOS :
* L'[http://morphos-files.net/download/Lua Lua archive] '''obsolète''' contient de la documentation spécifique MorphOS, mais surtout '''NE PAS INSTALLER''' de binaires à partir de cette archive !

== Debugging on MorphOS ==
* [http://krashan.ppa.pl/articles/luaexplorador/ Lua Explorador] is a MUI based source level debugger for Lua programs.


== Exemple simple ==
Un exemple simple avec des mots :
 <nowiki>
require("io")
require("string")

local firstvar="MorphOS"
local secondvar="Rulez"

io.write(firstvar)
io.write(" "..string.upper(secondvar).."!\n")
</nowiki>
Puis lancez à partir du shell :
 <nowiki>
Ram Disk:> luax example.lua
MorphOS RULEZ!
Ram Disk:>
</nowiki>

== Exemples de code source ==
* Quelques scripts spécifiques MorphOS peuvent être trouvé [http://jpv.wmhost.com/morphos/ ICI].
* La page [http://lua-users.org/wiki/SampleCode SampleCode] sur [http://lua-users.org lua-users.org].