Getting Started with Lua - Revision history

JPV at 17:49, 18 December 2018

2018-12-18T17:49:33Z

JPV at 16:15, 16 May 2018

2018-05-16T16:15:39Z

JPV at 16:15, 16 May 2018

2018-05-16T16:15:27Z

JPV at 18:50, 14 February 2016

2016-02-14T18:50:43Z

JPV at 18:53, 13 February 2016

2016-02-13T18:53:58Z

JPV at 14:53, 13 February 2016

2016-02-13T14:53:07Z

JPV at 08:02, 13 February 2016

2016-02-13T08:02:38Z

JPV at 07:59, 13 February 2016

2016-02-13T07:59:29Z

JPV: Created page with "== About == [http://www.lua.org/about.html Lua] is a powerful, fast, lightweight, embeddable scripting language, which is well integrated into MorphOS. It even supports ARexx..."

2016-02-13T07:57:21Z

Created page with "== About == [http://www.lua.org/about.html Lua] is a powerful, fast, lightweight, embeddable scripting language, which is well integrated into MorphOS. It even supports ARexx..."

New page

== About ==
[http://www.lua.org/about.html Lua] is a powerful, fast, lightweight, embeddable scripting language, which is well integrated into MorphOS.
It even supports ARexx communication on MorphOS.

== Usage ==
The Lua interpreter is implemented as a system shared library (lua.library), which can be used internally from other programs with the [http://www.lua.org/manual/5.1/manual.html#3 C API] of Lua.

Lua can also be used as a stand-alone language by executing scripts with the [[Shell_Commands/LuaX|LuaX]] command on MorphOS.

== MorphOS Specific Features ==
=== Modules ===
Standard Lua libraries are implemented as shared modules and, unlike the standard Lua distribution, they have to be loaded separately with the ''require()'' function if needed.
The only module available immediately is ''package''.

The ''MOSSYS:Libs/Lua/'' directory contains all available modules. These are included in 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]

For example, a ''require("io")'' line is needed before you can use the ''io.write()'' fuction.

=== ARexx Communication ===
The ''ipc'' module contains the following functions to communicate with programs via their ARexx ports:

* ipc.'''address(port)''' - Sets the default ARexx port name for sending commands. ''ipc.address("COMMAND")'' executes commands as DOS shell commands (although Lua's ''os.execute()'' does the same).
* '''ipc.checkport(port)''' - Checks if an ARexx port is available.
* ipc.'''rx(command)''' - Sends an ARexx command to a port set with ipc.address. ARexx's RESULT is returned as the result of the function. Lua variable ''rc'' is also set to the ARexx's RC result.
* '''ipc.waitforport(name[, interval])''' - Waits for a public port to appear. The script is aborted if the port isn't found after the specified interval of time (the default interval is 5 seconds).

Note: address() and rx() functions are registered in the global Lua namespace and should be called without the ''ipc.'' prefix.

Example:
<nowiki>
-- Let's load the module we need:
require("ipc")

-- If OWB's port is found, let's open the official MorphOS page and cycle the fullscreen mode:
if ipc.checkport("OWB.1") then
address("OWB.1")
rx("OPEN NAME http://www.morphos-team.net/")
rx("FULLSCREEN")
end</nowiki>

If the previous example is saved to a file called ''test.lua'', it can be executed from the shell with the ''LuaX test.lua'' command.

== Documentation ==
It's easy to find all kinds of documentation and solutions for your problems for Lua from the Internet, but here are some recommendations.

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

Tutorials by Lua users:
* [http://lua-users.org/wiki/TutorialDirectory Tutorial Directory]

MorphOS autodocs and examples:
* The '''outdated''' [http://morphos-files.net/download/Lua Lua archive] contains some MorphOS specific documentation, but '''DO NOT INSTALL''' any binaries from it!

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

== Source Code Examples ==
* Few MorphOS specific scripts can be found [http://jpv.wmhost.com/morphos/ here].
* The [http://lua-users.org/wiki/SampleCode SampleCode] page at [http://lua-users.org lua-users.org].

← Older revision		Revision as of 17:49, 18 December 2018
Line 67:		Line 67:

	MorphOS autodocs and examples:		MorphOS autodocs and examples:
		+	* Up-to-date autodocs are included in the [http://www.morphos.de/downloads MorphOS SDK]
	* The '''outdated''' [http://morphos-files.net/download/Lua Lua archive] contains some MorphOS specific documentation, but '''DO NOT INSTALL''' any binaries from it!		* The '''outdated''' [http://morphos-files.net/download/Lua Lua archive] contains some MorphOS specific documentation, but '''DO NOT INSTALL''' any binaries from it!

← Older revision		Revision as of 07:59, 13 February 2016
Line 28:		Line 28:
	* [http://www.lua.org/manual/5.1/manual.html#5.5 table]		* [http://www.lua.org/manual/5.1/manual.html#5.5 table]

−	For example, a ''require("io")'' line is needed before you can use the ''io.write()'' fuction.	+	For example, a '''require("io")''' line is needed before you can use the ''io.write()'' fuction.

@@ Line 15: / Line 15: @@
 The only module available immediately is ''package''.
-The ''MOSSYS:Libs/Lua/'' directory contains all available modules. These are included in MorphOS 3.9:
+The ''MOSSYS:Libs/Lua/'' directory contains all available modules. These are included in MorphOS 3.10:
 * [http://www.lua.org/manual/5.1/manual.html#5.1 base]
 * [http://www.lua.org/manual/5.1/manual.html#5.2 coroutine]

@@ Line 19: / Line 19: @@
 * [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]
@@ Line 24: / Line 25: @@
 * [http://www.lua.org/manual/5.1/manual.html#5.6 math]
 * [http://www.lua.org/manual/5.1/manual.html#5.8 os]
 * [http://www.lua.org/manual/5.1/manual.html#5.4 string]
 * [http://www.lua.org/manual/5.1/manual.html#5.5 table]

@@ Line 34: / Line 34: @@
 The ''ipc'' module contains the following functions to communicate with programs via their ARexx ports:
-* ipc.'''address(port)''' - Sets the default ARexx port name for sending commands. ''ipc.address("COMMAND")'' executes commands as DOS shell commands (although Lua's ''os.execute()'' does the same).
+* ipc.'''address(port)''' - Sets the default ARexx port name for sending commands. ''address("COMMAND")'' executes commands as DOS shell commands (although Lua's ''os.execute()'' does the same).
 * '''ipc.checkport(port)''' - Checks if an ARexx port is available.
 * ipc.'''rx(command)''' - Sends an ARexx command to a port set with ipc.address. ARexx's RESULT is returned as the result of the function. Lua variable ''rc'' is also set to the ARexx's RC result.

@@ Line 1: / Line 1: @@
 == About ==
 [http://www.lua.org/about.html Lua] is a powerful, fast, lightweight, embeddable scripting language, which is well integrated into MorphOS.
-It even supports ARexx communication on MorphOS.
+It even supports ARexx port communication on MorphOS.

@@ Line 73: / Line 73: @@
 * [http://krashan.ppa.pl/articles/luaexplorador/ Lua Explorador] is a MUI based source level debugger for Lua programs.
 == Source Code Examples ==
 * Few MorphOS specific scripts can be found [http://jpv.wmhost.com/morphos/ here].
 * The [http://lua-users.org/wiki/SampleCode SampleCode] page at [http://lua-users.org lua-users.org].

@@ Line 12: / Line 12: @@
 == MorphOS Specific Features ==
 === Modules ===
-Standard Lua libraries are implemented as shared modules and, unlike the standard Lua distribution, they have to be loaded separately with the ''require()'' function if needed.
+Standard Lua libraries are implemented as shared modules and, unlike the standard Lua distribution, they have to be loaded separately with the '''require()''' function if needed.
 The only module available immediately is ''package''.