Axuda:Lua

Esta é unha referencia básica de uso da linguaxe Lua con Scribunto para a Wikipedia.

Estruturas de control

se ... entón...

se ... entón... se non ...

se ... entón... ou se ... se non ...

if cor == 'negro' then
    cssCor = '#000'
end

if cor == 'negro' then
    cssColor = '#000'
else
    cssCor = cor
end

if cor == 'negro' then
    cssCor = '#000'
elseif cor == 'branco' then
    cssCor = '#fff'
else
    cssColor = color
end

Os signos == comproban a igualdade. Un só signo = asigna un valor.

Bucle for:

f = 1 -- asigna o valor inicial
for i = 1, 5 do
    f = f * i
end
return 'O factorial de 5 é ' .. f

Os dous guións - designan un comentario. Os dous puntos seguidos .. concatenan dúas cadeas de caracteres ou variables.

Funcións

Declaración de funciones:

sen argumentos	con argumentos	función non local para chamar fóra do módulo
local function getColour() return 'azul' end	local function plural(mundo) return mundo .. 's' end	local p = {} function p.ola() return '¡Ola mundo!' end return p

Para chamar á función:

colour = getColour()
colorPlural = plural('azul')

Variables

Hai tres tipos de variables: variables globais, variables locais e táboas. Unha variable considerase global a non ser que se declare explicitamente coa clave local. Unha variable local é visible dentro do bloque onde foi declarada. Unha variable declarada sen asignación ten valor nil (nulo).

x = 10           -- variable global
do               -- novo bloque
    local x = x  -- nova x asignada ao valor da anterior
    x = x + 1    -- 11
end              -- pecha o bloque e as súas variables locais
return x         -- 10, a global

local x
if ready then
    x = 'vai aló'
end
-- x é 'vai aló' se
-- ready, se non é nulo

Creación dunha táboa:

números = {un = 1, dous = 2, tres = 3}

Acceso a un elemento da táboa:

return números.dous    -- retorna 2
return números['dous'] -- tamén retorna 2

Táboa numerada:

africanFlatbreads = {
    'Aish Mehahra',
    'Injera',
    'Lahoh',
    'Ngome'
}
return africanFlatbreads[2] -- retorna 'Injera'

Iteración de elementos da táboa:

`pairs`: par clave/valor en orde aleatoria	`ipairs`: claves numéricas en orde ascendente
for nome, número in pairs(números) do ... end	for index, bread in ipairs(africanFlatbreads) do ... end

Cadeas de caracteres

`#`, lonxitude	`sub`, substring
s = 'ola' return #s -- retorna 3	s = 'olas' return s:sub(2,3) -- devuelve 'la' return s:sub(2) -- devuelve 'las' return s:sub(-2) -- devuelve 'as'

Léxico

Formato de comentarios:

    -- comentario nunha única liña
    --[[
    comentario largo
    --]]

Ignóranse os saltos de liña.
Os puntos e comas para terminar as declaracións son opcionais e non recomendados.

Tipos de datos

Cadea de caracteres (string), entre comiñas simples ('...') ou dobres ("..."). (8-bit)
Numèricos, un único formato de punto flotante de precisión doble.
Booleano: "true" ou "false" (verdadeiro ou falso)
"Nil" (nulo)
Táboas
- Implementadas coma hashtable
- Empregadas para OOP, com Javascript
- Sintaxe literal: {nome = valor} ou {a, b, c}
- Acceso con foo.bar ou foo['bar']
Funcións
- Valores de primeira clase.
- Retornan valores múltiples.
- Os valores de retorno múltiples non están ligados a un tipo de dato.
- Sintáxe anónima

x = function()
    ...
end

Operadores

Non igual: ~= (en lugar de !=)
Concatenación: ..
Lonxitude: #
Lóxicos: and, or, not

`and`: Os dous son verdadesros	`or`: Un, outro ou ámbolos dous	`not`: O seguinte é falso
if lacón and grelos then return 'cocido' end	if pomba or águia then return 'paxaro' end	if not dormido then return 'esperto' end

Exponencial: ^
Có significado habitual: <, >, <=, >=, ==, +, -, *, /, %
Operadores omitidos:
- Ningún operador de asignación con +=. Un só igual = non se considera realmente un operador.
- Ningún operador bit a bit
- Ningún operador ternario ?:
Asignación. Coma en BASIC, a asignación é unha declaración completa, no unha expresión.

Asignación múltiple	Asignación con declaración de variable local
a, b = c, d a, b = foo()	local a, b = c, d local a = b, c = d -- así non!

Datos

Variables
- Ámbito léxico, case idéntico a JavaScript.
- Unha variable non determinada é idéntica a unha variable nula.
- Ningunha sintaxe especial para suprimir, simplemente x = nil.
- O acceso a variables non definidas non xera erros.
Obxectos
- Feitos con táboas, empregando unha variedade de sintaxe, semellante á JavaScript.
- Variables de elementos privados implementadas con ámbito léxico, coma en JavaScript.
- Punto para métodos estáticos: obj.func ()
- Dous puntos para métodos non estáticos: obj: func ()
- Exemplo de estilo de construción dunha función:

function newObj()
    local private = 1
    local obj = {}
    function obj:getPrivate()
        return private
    end
    return obj
end

Metatáboas
- Cada táboa pode ter unha metatáboa asociada
- Proporciona sobrecarga de operadores
- O campo índice da metatáboa emprégase para a herdanza de obxectos e a programación baseada en prototipos.

Interface de MediaWiki

Todo o código Lua está no espazo de nomes "Módulo".

Invocación:

{{ #invoke: nome_módulo | nome_función | arg1 | arg2 | nome1 = valor1 }}

As instancias de invocación son illadas, os globais definidos nunha non están dispoñibles noutra.

Un módulo é un bloque Lua que retorna unha táboa de exportación. Proporcionase require () e a libraría package. A función de exportación retorna unha cadea de texto wiki, convertendo os valores que non son string. Os valores múltiples de retorno son concatenados.

Métodos frame:

args:

local nome1 = frame.args.nome1

argumentPairs():

local t = {}
for nome, valor in frame:argumentPairs() do
    t[name] = value
end

getParent(): Proporciona acceso ao frame superior, por exemplo os argumentos do modelo que chamou #invoke
Preproceso de texto wiki

frame:preprocess('{{modelo}}')

Invocación estructurada de modelo

frame:expandTemplate{
    title = 'modelo',
    args = {foo = foo}}

Os argumentos son sempre expandidos. Non é necesario construír preprocesar as entradas dos argumentos.

Véxase tamén

Outros artigos

Wikipedia:Guía de estilo de Lua
Scribunto/Lua referencia manual en Mediawiki (en inglés)

Ligazóns externas

Programming in Lua (en inglés)
Manual de referencia ver 5.1 (en castelán)
Manual de referencia ver 5.2 (en inglés)
Lua-users (en inglés)

Volver á páxina de axuda.