Lua

Template:Short description Template:Other Template:Use dmy dates Template:Infobox programming language

Lua Template:Noexcerpt is a lightweight, high-level, multi-paradigm programming language designed mainly for embedded use in applications.<ref name="luaspe">Template:Cite journal</ref> Lua is cross-platform software, since the interpreter of compiled bytecode is written in ANSI C,<ref name=luaabout>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> and Lua has a relatively simple C application programming interface (API) to embed it into applications.<ref>Template:Cite magazine</ref>

Lua originated in 1993 as a language for extending software applications to meet the increasing demand for customization at the time. It provided the basic facilities of most procedural programming languages, but more complicated or domain-specific features were not included; rather, it included mechanisms for extending the language, allowing programmers to implement such features. As Lua was intended to be a general embeddable extension language, the designers of Lua focused on improving its speed, portability, extensibility and ease-of-use in development.

HistoryEdit

Lua was created in 1993 by Roberto Ierusalimschy, Luiz Henrique de Figueiredo and Waldemar Celes, members of the Computer Graphics Technology Group (Tecgraf) at the Pontifical Catholic University of Rio de Janeiro, in Brazil.

From 1977 until 1992, Brazil had a policy of strong trade barriers (called a market reserve) for computer hardware and software, believing that Brazil could and should produce its own hardware and software. In that climate, Tecgraf's clients could not afford, either politically or financially, to buy customized software from abroad; under the market reserve, clients would have to go through a complex bureaucratic process to prove their needs couldn't be met by Brazilian companies. Those reasons led Tecgraf to implement the basic tools it needed from scratch.<ref name=hopl2007>Template:Cite book</ref>

Lua's predecessors were the data-description and configuration languages Simple Object Language (SOL) and Data-Entry Language (DEL).<ref name="luahist2001">{{#invoke:citation/CS1|citation |CitationClass=web }} </ref> They had been independently developed at Tecgraf in 1992–1993 to add some flexibility into two different projects (both were interactive graphical programs for engineering applications at Petrobras company). There was a lack of any flow-control structures in SOL and DEL, and Petrobras felt a growing need to add full programming power to them.

In The Evolution of Lua, the language's authors wrote:<ref name=hopl2007/>

In 1993, the only real contender was Tcl, which had been explicitly designed to be embedded into applications. However, Tcl had unfamiliar syntax, did not offer good support for data description, and ran only on Unix platforms. We did not consider LISP or Scheme because of their unfriendly syntax. Python was still in its infancy. In the free, do-it-yourself atmosphere that then reigned in Tecgraf, it was quite natural that we should try to develop our own scripting language ... Because many potential users of the language were not professional programmers, the language should avoid cryptic syntax and semantics. The implementation of the new language should be highly portable, because Tecgraf's clients had a very diverse collection of computer platforms. Finally, since we expected that other Tecgraf products would also need to embed a scripting language, the new language should follow the example of SOL and be provided as a library with a C API.{{#if:|{{#if:|}}
— {{#if:|, in }}Template:Comma separated entries
}}

{{#invoke:Check for unknown parameters|check|unknown=Template:Main other|preview=Page using Template:Blockquote with unknown parameter "_VALUE_"|ignoreblank=y| 1 | 2 | 3 | 4 | 5 | author | by | char | character | cite | class | content | multiline | personquoted | publication | quote | quotesource | quotetext | sign | source | style | text | title | ts }}

Lua 1.0 was designed in such a way that its object constructors, being then slightly different from the current light and flexible style, incorporated the data-description syntax of SOL (hence the name Lua: Sol meaning "Sun" in Portuguese, and Lua meaning "Moon"). Lua syntax for control structures was mostly borrowed from Modula (if, while, repeat/until), but also had taken influence from CLU (multiple assignments and multiple returns from function calls, as a simpler alternative to reference parameters or explicit pointers), C++ ("neat idea of allowing a local variable to be declared only where we need it"<ref name=hopl2007/>), SNOBOL and AWK (associative arrays). In an article published in Dr. Dobb's Journal, Lua's creators also state that LISP and Scheme with their single, ubiquitous data-structure mechanism (the list) were a major influence on their decision to develop the table as the primary data structure of Lua.<ref name=ddj96>Template:Cite news</ref>

Lua semantics have been increasingly influenced by Scheme over time,<ref name=hopl2007/> especially with the introduction of anonymous functions and full lexical scoping. Several features were added in new Lua versions.

Versions of Lua prior to version 5.0 were released under a license similar to the BSD license. From version 5.0 onwards, Lua has been licensed under the MIT License. Both are permissive free software licences and are almost identical.

FeaturesEdit

Lua is commonly described as a "multi-paradigm" language, providing a small set of general features that can be extended to fit different problem types. Lua does not contain explicit support for inheritance, but allows it to be implemented with metatables. Similarly, Lua allows programmers to implement namespaces, classes and other related features using its single table implementation; first-class functions allow the employment of many techniques from functional programming and full lexical scoping allows fine-grained information hiding to enforce the principle of least privilege.

In general, Lua strives to provide simple, flexible meta-features that can be extended as needed, rather than supply a feature-set specific to one programming paradigm. As a result, the base language is light; the full reference interpreter is only about 247 kB compiled<ref name=luaabout/> and easily adaptable to a broad range of applications.

As a dynamically typed language intended for use as an extension language or scripting language, Lua is compact enough to fit on a variety of host platforms. It supports only a small number of atomic data structures such as Boolean values, numbers (double-precision floating point and 64-bit integers by default) and strings. Typical data structures such as arrays, sets, lists and records can be represented using Lua's single native data structure, the table, which is essentially a heterogeneous associative array.

Lua implements a small set of advanced features such as first-class functions, garbage collection, closures, proper tail calls, coercion (automatic conversion between string and number values at run time), coroutines (cooperative multitasking) and dynamic module loading.

SyntaxEdit

The classic "Hello, World!" program can be written as follows, with or without parentheses:<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>Template:Efn <syntaxhighlight lang="lua"> print("Hello, World!") </syntaxhighlight> <syntaxhighlight lang="lua"> print "Hello, World!" </syntaxhighlight>

The declaration of a variable, without a value. <syntaxhighlight lang="lua"> local variable </syntaxhighlight>

The declaration of a variable with a value of 10. <syntaxhighlight lang="lua"> local students = 10 </syntaxhighlight>

A comment in Lua starts with a double-hyphen and runs to the end of the line, similar to Ada, Eiffel, Haskell, SQL and VHDL. Multi-line strings and comments are marked with double square brackets. <syntaxhighlight lang="lua"> -- Single line comment --[[ Multi-line comment --]] </syntaxhighlight>

Template:AnchorThe factorial function is implemented in this example: <syntaxhighlight lang="lua"> function factorial(n)

 local x = 1
 for i = 2, n do
   x = x * i
 end
 return x

end </syntaxhighlight>

Control flowEdit

Lua has one type of conditional test: if then end with optional else and elseif then execution control constructs.

The generic if then end statement requires all three keywords: <syntaxhighlight lang="lua"> if condition then --statement body end </syntaxhighlight>

An example of an if statement <syntaxhighlight lang="lua"> if x ~= 10 then print(x) end </syntaxhighlight>

The else keyword may be added with an accompanying statement block to control execution when the if condition evaluates to false: <syntaxhighlight lang="lua"> if condition then --statement body else --statement body end </syntaxhighlight>

An example of an if else statement <syntaxhighlight lang="lua"> if x == 10 then print(10) else print(x) end </syntaxhighlight>

Execution may also be controlled according to multiple conditions using the elseif then keywords: <syntaxhighlight lang="lua"> if condition then --statement body elseif condition then --statement body else -- optional --optional default statement body end </syntaxhighlight> An example of an if elseif else statement <syntaxhighlight lang="lua"> if x == y then print("x = y") elseif x == z then print("x = z") else -- optional print("x does not equal any other variable") end </syntaxhighlight>

Lua has four types of conditional loops: the while loop, the repeat loop (similar to a do while loop), the numeric for loop and the generic for loop. <syntaxhighlight lang="lua"> --condition = true

while condition do

 --statements

end

repeat

 --statements

until condition

for i = first, last, delta do --delta may be negative, allowing the for loop to count down or up

 --statements
 --example: print(i)

end </syntaxhighlight>

This generic for loop would iterate over the table _G using the standard iterator function pairs, until it returns nil: <syntaxhighlight lang="lua"> for key, value in pairs(_G) do

 print(key, value)

end </syntaxhighlight>

Loops can also be nested (put inside of another loop). <syntaxhighlight lang="lua"> local grid = {

 { 11, 12, 13 },
 { 21, 22, 23 },
 { 31, 32, 33 }

}

for y, row in pairs(grid) do

 for x, value in pairs(row) do
   print(x, y, value)
 end

end </syntaxhighlight>

FunctionsEdit

Lua's treatment of functions as first-class values is shown in the following example, where the print function's behavior is modified: <syntaxhighlight lang="lua"> do

 local oldprint = print
 -- Store current print function as oldprint
 function print(s)
   --[[ Redefine print function. The usual print function can still be used
     through oldprint. The new one has only one argument.]]
   oldprint(s == "foo" and "bar" or s)
 end

end </syntaxhighlight> Any future calls to print will now be routed through the new function, and because of Lua's lexical scoping, the old print function will only be accessible by the new, modified print.

Lua also supports closures, as demonstrated below: <syntaxhighlight lang="lua"> function addto(x)

 -- Return a new function that adds x to the argument
 return function(y)
   --[[ When we refer to the variable x, which is outside the current
     scope and whose lifetime would be shorter than that of this anonymous
     function, Lua creates a closure.]]
   return x + y
 end

end fourplus = addto(4) print(fourplus(3)) -- Prints 7

--This can also be achieved by calling the function in the following way: print(addto(4)(3)) --[[ This is because we are calling the returned function from 'addto(4)' with the argument '3' directly.

 This also helps to reduce data cost and up performance if being called iteratively.]]

</syntaxhighlight> A new closure for the variable x is created every time addto is called, so that each new anonymous function returned will always access its own x parameter. The closure is managed by Lua's garbage collector, just like any other object.

TablesEdit

Tables are the most important data structures (and, by design, the only built-in composite data type) in Lua and are the foundation of all user-created types. They are associative arrays with addition of automatic numeric key and special syntax.

A table is a set of key and data pairs, where the data is referenced by key; in other words, it is a hashed heterogeneous associative array.

Tables are created using the {} constructor syntax.

<syntaxhighlight lang="lua"> a_table = {} -- Creates a new, empty table </syntaxhighlight>

Tables are always passed by reference (see Call by sharing).

A key (index) can be any value except nil and NaN, including functions.

<syntaxhighlight lang="lua"> a_table = {x = 10} -- Creates a new table, with one entry mapping "x" to the number 10. print(a_table["x"]) -- Prints the value associated with the string key, in this case 10. b_table = a_table b_table["x"] = 20 -- The value in the table has been changed to 20. print(b_table["x"]) -- Prints 20. print(a_table["x"]) -- Also prints 20, because a_table and b_table both refer to the same table. </syntaxhighlight>

A table is often used as structure (or record) by using strings as keys. Because such use is very common, Lua features a special syntax for accessing such fields.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

<syntaxhighlight lang="lua"> point = { x = 10, y = 20 } -- Create new table print(point["x"]) -- Prints 10 print(point.x) -- Has exactly the same meaning as line above. The easier-to-read dot notation is just syntactic sugar. </syntaxhighlight>

By using a table to store related functions, it can act as a namespace.

<syntaxhighlight lang="lua"> Point = {}

Point.new = function(x, y)

 return {x = x, y = y}  --  return {["x"] = x, ["y"] = y}

end

Point.set_x = function(point, x)

 point.x = x  --  point["x"] = x;

end </syntaxhighlight>

Tables are automatically assigned a numerical key, enabling them to be used as an array data type. The first automatic index is 1 rather than 0 as it is for many other programming languages (though an explicit index of 0 is allowed).

A numeric key 1 is distinct from a string key "1".

<syntaxhighlight lang="lua"> array = { "a", "b", "c", "d" } -- Indices are assigned automatically. print(array[2]) -- Prints "b". Automatic indexing in Lua starts at 1. print(#array) -- Prints 4. # is the length operator for tables and strings. array[0] = "z" -- Zero is a legal index. print(#array) -- Still prints 4, as Lua arrays are 1-based. </syntaxhighlight>

The length of a table t is defined to be any integer index n such that t[n] is not nil and t[n+1] is nil; moreover, if t[1] is nil, n can be zero. For a regular array, with non-nil values from 1 to a given n, its length is exactly that n, the index of its last value. If the array has "holes" (that is, nil values between other non-nil values), then #t can be any of the indices that directly precedes a nil value (that is, it may consider any such nil value as the end of the array).<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

<syntaxhighlight lang="lua"> ExampleTable = {

 {1, 2, 3, 4},
 {5, 6, 7, 8}

} print(ExampleTable[1][3]) -- Prints "3" print(ExampleTable[2][4]) -- Prints "8" </syntaxhighlight>

A table can be an array of objects.

<syntaxhighlight lang="lua"> function Point(x, y) -- "Point" object constructor

 return { x = x, y = y }   -- Creates and returns a new object (table)

end array = { Point(10, 20), Point(30, 40), Point(50, 60) } -- Creates array of points

                       -- array = { { x = 10, y = 20 }, { x = 30, y = 40 }, { x = 50, y = 60 } };

print(array[2].y) -- Prints 40 </syntaxhighlight>

Using a hash map to emulate an array is normally slower than using an actual array; however, Lua tables are optimized for use as arrays to help avoid this issue.<ref name=lobject_h_array>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

MetatablesEdit

Extensible semantics is a key feature of Lua, and the metatable concept allows powerful customization of tables. The following example demonstrates an "infinite" table. For any n, fibs[n] will give the n-th Fibonacci number using dynamic programming and memoization. <syntaxhighlight lang="lua"> fibs = { 1, 1 } -- Initial values for fibs[1] and fibs[2]. setmetatable(fibs, {

 __index = function(values, n)                --[[__index is a function predefined by Lua, 
                                                  it is called if key "n" does not exist.]]
   values[n] = values[n - 1] + values[n - 2]  -- Calculate and memoize fibs[n].
   return values[n]
 end

}) </syntaxhighlight>

Object-oriented programmingEdit

Although Lua does not have a built-in concept of classes, object-oriented programming can be emulated using functions and tables. An object is formed by putting methods and fields in a table. Inheritance (both single and multiple) can be implemented with metatables, delegating nonexistent methods and fields to a parent object.

There is no such concept as "class" with these techniques; rather, prototypes are used, similar to Self or JavaScript. New objects are created either with a factory method (that constructs new objects from scratch) or by cloning an existing object.

Creating a basic vector object: <syntaxhighlight lang="lua"> local Vector = {} local VectorMeta = { __index = Vector}

function Vector.new(x, y, z) -- The constructor

 return setmetatable({x = x, y = y, z = z}, VectorMeta)

end

function Vector.magnitude(self) -- Another method

 return math.sqrt(self.x^2 + self.y^2 + self.z^2)

end

local vec = Vector.new(0, 1, 0) -- Create a vector print(vec.magnitude(vec)) -- Call a method (output: 1) print(vec.x) -- Access a member variable (output: 0) </syntaxhighlight>

Here, <syntaxhighlight lang="lua" class="" style="" inline="1">setmetatable</syntaxhighlight> tells Lua to look for an element in the <syntaxhighlight lang="lua" class="" style="" inline="1">Vector</syntaxhighlight> table if it is not present in the <syntaxhighlight lang="lua" class="" style="" inline="1">vec</syntaxhighlight> table. <syntaxhighlight lang="lua" class="" style="" inline="1">vec.magnitude</syntaxhighlight>, which is equivalent to <syntaxhighlight lang="lua" class="" style="" inline="1">vec["magnitude"]</syntaxhighlight>, first looks in the <syntaxhighlight lang="lua" class="" style="" inline="1">vec</syntaxhighlight> table for the <syntaxhighlight lang="lua" class="" style="" inline="1">magnitude</syntaxhighlight> element. The <syntaxhighlight lang="lua" class="" style="" inline="1">vec</syntaxhighlight> table does not have a <syntaxhighlight lang="lua" class="" style="" inline="1">magnitude</syntaxhighlight> element, but its metatable delegates to the <syntaxhighlight lang="lua" class="" style="" inline="1">Vector</syntaxhighlight> table for the <syntaxhighlight lang="lua" class="" style="" inline="1">magnitude</syntaxhighlight> element when it's not found in the <syntaxhighlight lang="lua" class="" style="" inline="1">vec</syntaxhighlight> table.

Lua provides some syntactic sugar to facilitate object orientation. To declare member functions inside a prototype table, one can use <syntaxhighlight lang="lua" class="" style="" inline="1">function table:func(args)</syntaxhighlight>, which is equivalent to <syntaxhighlight lang="lua" class="" style="" inline="1">function table.func(self, args)</syntaxhighlight>. Calling class methods also makes use of the colon: <syntaxhighlight lang="lua" class="" style="" inline="1">object:func(args)</syntaxhighlight> is equivalent to <syntaxhighlight lang="lua" class="" style="" inline="1">object.func(object, args)</syntaxhighlight>.

That in mind, here is a corresponding class with <syntaxhighlight lang="lua" class="" style="" inline="1">:</syntaxhighlight> syntactic sugar:

<syntaxhighlight lang="lua"> local Vector = {} Vector.__index = Vector

function Vector:new(x, y, z) -- The constructor

 -- Since the function definition uses a colon, 
 -- its first argument is "self" which refers
 -- to "Vector"
 return setmetatable({x = x, y = y, z = z}, self)

end

function Vector:magnitude() -- Another method

 -- Reference the implicit object using self
 return math.sqrt(self.x^2 + self.y^2 + self.z^2)

end

local vec = Vector:new(0, 1, 0) -- Create a vector print(vec:magnitude()) -- Call a method (output: 1) print(vec.x) -- Access a member variable (output: 0) </syntaxhighlight>

InheritanceEdit

Lua supports using metatables to give Lua class inheritance.<ref>Template:Cite book</ref> In this example, we allow vectors to have their values multiplied by a constant in a derived class.

<syntaxhighlight lang="lua"> local Vector = {} Vector.__index = Vector

function Vector:new(x, y, z) -- The constructor

 -- Here, self refers to whatever class's "new"
 -- method we call.  In a derived class, self will
 -- be the derived class; in the Vector class, self
 -- will be Vector
 return setmetatable({x = x, y = y, z = z}, self)

end

function Vector:magnitude() -- Another method

 -- Reference the implicit object using self
 return math.sqrt(self.x^2 + self.y^2 + self.z^2)

end

-- Example of class inheritance local VectorMult = {} VectorMult.__index = VectorMult setmetatable(VectorMult, Vector) -- Make VectorMult a child of Vector

function VectorMult:multiply(value)

 self.x = self.x * value
 self.y = self.y * value
 self.z = self.z * value
 return self

end

local vec = VectorMult:new(0, 1, 0) -- Create a vector print(vec:magnitude()) -- Call a method (output: 1) print(vec.y) -- Access a member variable (output: 1) vec:multiply(2) -- Multiply all components of vector by 2 print(vec.y) -- Access member again (output: 2) </syntaxhighlight>

Lua also supports multiple inheritance; <syntaxhighlight lang="text" class="" style="" inline="1">__index</syntaxhighlight> can either be a function or a table.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> Operator overloading can also be done; Lua metatables can have elements such as <syntaxhighlight lang="text" class="" style="" inline="1">__add</syntaxhighlight>, <syntaxhighlight lang="text" class="" style="" inline="1">__sub</syntaxhighlight> and so on.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

ImplementationEdit

Lua programs are not interpreted directly from the textual Lua file, but are compiled into bytecode, which is then run on the Lua virtual machine (VM). The compiling process is typically invisible to the user and is performed during run-time, especially when a just-in-time compilation (JIT) compiler is used, but it can be done offline to increase loading performance or reduce the memory footprint of the host environment by leaving out the compiler. Lua bytecode can also be produced and executed from within Lua, using the dump function from the string library and the load/loadstring/loadfile functions. Lua version 5.3.4 is implemented in approximately 24,000 lines of C code.<ref name="luaspe"/><ref name="luaabout"/>

Like most CPUs, and unlike most virtual machines (which are stack-based), the Lua VM is register-based, and therefore more closely resembles most hardware design. The register architecture both avoids excessive copying of values, and reduces the total number of instructions per function. The virtual machine of Lua 5 is one of the first register-based pure VMs to have a wide use.<ref name=lua5impl>Template:Cite journal</ref> Parrot and Android's Dalvik are two other well-known register-based VMs. PCScheme's VM was also register-based.<ref>Template:Cite book</ref>

This example is the bytecode listing of the factorial function defined above (as shown by the luac 5.1 compiler):<ref name=luavm51instr>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

function <factorial.lua:1,7> (9 instructions, 36 bytes at 0x8063c60)
1 param, 6 slots, 0 upvalues, 6 locals, 2 constants, 0 functions
	1	[2]	LOADK    	1 -1	; 1
	2	[3]	LOADK    	2 -2	; 2
	3	[3]	MOVE     	3 0
	4	[3]	LOADK    	4 -1	; 1
	5	[3]	FORPREP  	2 1	; to 7
	6	[4]	MUL      	1 1 5
	7	[3]	FORLOOP  	2 -2	; to 6
	8	[6]	RETURN   	1 2
	9	[7]	RETURN   	0 1

C APIEdit

Lua is intended to be embedded into other applications, and provides a C API for this purpose. The API is divided into two parts: the Lua core and the Lua auxiliary library.<ref name="luarefman">{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> The Lua API's design eliminates the need for manual reference counting (management) in C code, unlike Python's API. The API, like the language, is minimalist. Advanced functions are provided by the auxiliary library, which consists largely of preprocessor macros which assist with complex table operations.

The Lua C API is stack based. Lua provides functions to push and pop most simple C data types (integers, floats, etc.) to and from the stack, and functions to manipulate tables through the stack. The Lua stack is somewhat different from a traditional stack; the stack can be indexed directly, for example. Negative indices indicate offsets from the top of the stack. For example, −1 is the top (most recently pushed value), while positive indices indicate offsets from the bottom (oldest value). Marshalling data between C and Lua functions is also done using the stack. To call a Lua function, arguments are pushed onto the stack, and then the lua_call is used to call the actual function. When writing a C function to be directly called from Lua, the arguments are read from the stack.

Here is an example of calling a Lua function from C:

include <stdio.h>
include <lua.h> // Lua main library (lua_*)
include <lauxlib.h> // Lua auxiliary library (luaL_*)

int main(void) {

   // create a Lua state
   lua_State *L = luaL_newstate();

   // load and execute a string
   if (luaL_dostring(L, "function foo (x,y) return x+y end")) {
       lua_close(L);
       return -1;
   }

   // push value of global "foo" (the function defined above)
   // to the stack, followed by integers 5 and 3
   lua_getglobal(L, "foo");
   lua_pushinteger(L, 5);
   lua_pushinteger(L, 3);
   lua_call(L, 2, 1); // call a function with two arguments and one return value
   printf("Result: %d\n", lua_tointeger(L, -1)); // print integer value of item at stack top
   lua_pop(L, 1); // return stack to original state
   lua_close(L); // close Lua state
   return 0;

} </syntaxhighlight>

Running this example gives: <syntaxhighlight lang="console"> $ cc -o example example.c -llua $ ./example Result: 8 </syntaxhighlight>

The C API also provides some special tables, located at various "pseudo-indices" in the Lua stack. At LUA_GLOBALSINDEX prior to Lua 5.2<ref name="Changes in the API, Lua 5.2 manual">Template:Cite book</ref> is the globals table, _G from within Lua, which is the main namespace. There is also a registry located at LUA_REGISTRYINDEX where C programs can store Lua values for later retrieval.

ModulesEdit

Besides standard library (core) modules it is possible to write extensions using the Lua API. Extension modules are shared objects which can be used to extend the functions of the interpreter by providing native facilities to Lua scripts. Lua scripts may load extension modules using require,<ref name="luarefman"/> just like modules written in Lua itself, or with package.loadlib.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> When a C library is loaded via Template:Ml-lua Lua will look for the function luaopen_foo and call it, which acts as any C function callable from Lua and generally returns a table filled with methods. A growing set of modules termed rocks are available through a package management system named LuaRocks,<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> in the spirit of CPAN, RubyGems and Python eggs. Prewritten Lua bindings exist for most popular programming languages, including other scripting languages.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> For C++, there are a number of template-based approaches and some automatic binding generators.

ApplicationsEdit

{{#invoke:Labelled list hatnote|labelledList|Main article|Main articles|Main page|Main pages}}

In video game development, Lua is widely used as a scripting language, mainly due to its perceived easiness to embed, fast execution, and short learning curve.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> Notable games which use Lua include Roblox,<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> Garry's Mod, World of Warcraft, Payday 2, Phantasy Star Online 2, Dota 2, Crysis,<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> and many others. Some games that do not natively support Lua programming or scripting, have this function added by mods, as ComputerCraft does for Minecraft. Also, Lua is used in non-video game software, such as Adobe Lightroom, Moho, iClone, Aerospike, and some system software in FreeBSD and NetBSD, and used as a template scripting language on MediaWiki using the Scribunto extension.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

In 2003, a poll conducted by GameDev.net showed Lua was the most popular scripting language for game programming.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> On 12 January 2012, Lua was announced as a winner of the Front Line Award 2011 from the magazine Game Developer in the category Programming Tools.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

Many non-game applications also use Lua for extensibility, such as LuaTeX, an implementation of the TeX type-setting language, Redis, a key-value database, ScyllaDB, a wide-column store, Neovim, a text editor, Nginx, a web server, Wireshark, a network packet analyzer and Pure Data, a visual audio programming language (through the pdlua extension).

Derived languagesEdit

Languages that compile to LuaEdit

MoonScript is a dynamic, whitespace-sensitive scripting language inspired by CoffeeScript, which is compiled into Lua. This means that instead of using do and end (or { and }) to delimit sections of code it uses line breaks and indentation style.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref><ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref><ref name=":1">{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> A notable use of MoonScript is the video game distribution website Itch.io.

Haxe supports compiling to some Lua targets, including Lua 5.1-5.3 and LuaJIT 2.0 and 2.1.
Fennel, a Lisp dialect that targets Lua.<ref name=":1"/>
Urn, a Lisp dialect built on Lua.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

Amulet, an ML-like functional programming language, which compiler emits Lua files.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

LunarML, Standard ML compiler that produces Lua/JavaScript<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

DialectsEdit

LuaJIT, a just-in-time compiler of Lua 5.1.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref><ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

Luau developed by Roblox Corporation, a derivative of and backwards-compatible with Lua 5.1 with gradual typing, additional features and a focus on performance.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref> Luau has improved sandboxing to allow for running untrusted code in embedded applications.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

Ravi, a JIT-enabled Lua 5.3 language with optional static typing. JIT is guided by type information.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

Shine, a fork of LuaJIT with many extensions, including a module system and a macro system.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

Glua, a modified version embedded into the game Garry's Mod as its scripting language.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

Teal, a statically typed Lua dialect written in Lua.<ref>Template:Citation</ref>
PICO-8, a "fantasy video game console", uses a subset of Lua known as PICO-8 Lua.

In addition, the Lua users community provides some power patches on top of the reference C implementation.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>