Para "quebrarmos" nossos programas em partes menores para organização e reuso, criamos funções. Em Lua, a declaração de função segue a sintaxe abaixo:

Sintaxe

escopo_funcao function nome_funcao() 
    --corpo
end

Onde

escopo_funcao: Se a função será interna(local) ao módulo ou não(Global).

Exemplo 1

local function funcao1()
  print("funcao1")
end

Saída

-

Uma função em Lua deve sempre ser declarada antes de ser chamada. Caso contrário, um erro de compilação será gerado.

A chamada de funções em Lua é semelhante as outras linguagens de programação. Basta invocar a função pelo seu nome:

Exemplo 2

local function funcao1()
  print("funcao1")
end

funcao1()

Saída

funcao1

Em Lua declaramos os parâmetros de uma função de acordo com a sintaxe mostrada abaixo: de dado:

Sintaxe

escopo_funcao function nome_funcao(param1, ... , paramN)
  --corpo
end

Onde

parm1…paramN: lista de parâmetros

Exemplo 3

function funcao(param1,param2)
  print(param1)
  print(param2)
end

funcao(1,"string")

Saída

1
string

É possível definir um valor padrão para um parâmetro de uma função. Na primeira linha do corpo da função, declaramos a atribuição de um valor default ao parâmetro como abaixo:

Sintaxe

escopo_funcao function nome_funcao(<nome_parametro>)
    <nome_parametro> = <nome_parametro> or valor_default
    --corpo
end

Exemplo 4

function funcao(param1,param2)
  param1 = param1 or "fulano"
  param2 = param2 or 1
  
  print(string.format("Olá %s",param1))
  print(param2)
end

funcao("Luna")

Saída

Olá Luna
1

Com valores padrão, caso nenhum parâmetro for informado ao invocarmos uma função, o compilador não irá gerar nenhum tipo de erro.

Caso seja necessário, podemos utilizar a função type para realizar a checagem do tipo de dado passado como argumento para uma função.

Sintaxe: type

type(nome_parametro)

Sintaxe

if ( type(nome_parametro ) then
   -- código
end

Exemplo 5

function funcao(param1,param2)
  if( type(param1) == "string") then
    print("param1:","string")
  end  
end

funcao("Luna")

Saída

param1:	string

Se nenhum parâmetro for informado ao invocarmos uma função, é necessário verificar se o parâmetro é nil.

O retorno de valores de funções em Lua é feito de forma mais simples comparado a outras linguagens. Não precisamos declarar o tipo de dados que a função irá retornar, apenas é necessário utilizar o comando return.

Sintaxe

return valor

Exemplo 6

function funcao1(v1,v2)
  return v1 + v2
end

local soma = funcao1(1,2)
print(soma)

As funções escritas em Lua podem retornar mais de um valor como em linguagens como Go e Rust. Para retornar de múltiplos valores em Lua, basta separar os valores por (,).

Sintaxe

return valor1, valor2, valorN

Exemplo 7

function funcao()
    return 1,'C',1.99,"string";
end

local a,b,c,d = funcao()

print(a)
print(b)
print(c)
print(d)

Saída

1
C
1.99
string

Com os comandos de decisão if ou if-elseif podemos utilizar o comando return uma ou mais vezes ao longo do corpo da função:

Exemplo 8

local x

function funcao(param)
  
  if( param%2 == 0) then
      return true
  end
  return false
end

print(funcao(2))

Saída

true

Quando aprendemos a função print para a exibição de informações, podemos perceber que essa função recebe um número de argumentos variável. Para que nossas funções possam ter o comportamento semelhante, utilizamos o operador (…) chamado de vararg.

Sintaxe

escopo_funcao function nome_funcao(...)
    --corpo
end

Exemplo 9

function funcao(...)
  print(...) --impressão de argumento
end

--passando argumentos
funcao(1,2,3,4,5)

Saída

1	2	3	4	5

Para descobrirmos o número de argumento passadas para as nossas funções que utilizam (…) podemos converter os argumentos em um vetor e utilizar o operador #.

Exemplo 10

function funcao(...)
  local var = {...}  --"empacotando" varargs em um vetor
 
  --percorrer vetor
  for i=1,#var,1 do --i=1 índice inicial 
    print(var[i])
  end
end

Saída

1
2
3
4
5

1. 15/09/2025 - revisão 3 - Ajustes: 'funções' reescrita, pontuais, sintaxes e objetivos; Adição: Ex. 8 e sintaxe retorno múltiplo
2. 12/09/2024 - revisão 2 - Ajustes em todos os tópicos
3. 03/10/2023 - revisão 1 - Correção em referências e erros gramaticais, correção em sintaxe e exemplos
4. 26/05/2023 - versão inicial