Arrays

Arrays são estruturas de dados que permitem armazenar uma coleção de elementos sequenciais, onde cada elemento é identificado por um índice numérico. Os arrays são implementados utilizando tabelas, onde os índices numéricos são utilizados para acessar os elementos da tabela.

LuaConsole

local meuArray = { 1, 2, 3, 4, 5 }


print(meuArray[1])
print(meuArray[2])
print(meuArray[3])
print(meuArray[4])
print(meuArray[5])

1
2
3
4
5

Note

As tabelas são estruturadas com índices iniciando em 1, não em 0. Isso significa que o primeiro elemento de uma tabela é acessado pelo índice 1, o segundo elemento pelo índice 2 e assim por diante.

Flexibilidade de Tipos

Uma das características interessantes dos arrays em Lua é a flexibilidade em relação aos tipos de dados armazenados. Ao contrário de algumas linguagens de programação, não é necessário que todos os elementos de um array em Lua sejam do mesmo tipo.

LuaConsole

local meuArray = {10, "Lua", true, {1, 2, 3}}

print(meuArray[1])
print(meuArray[2])
print(meuArray[3])
print(meuArray[4][2])

10
Lua
true
2

Adicionandos elementos em um array

Em Lua, é possível adicionar novos elementos em um array de forma simples, sem a necessidade de utilizar funções específicas. Basta atribuir um valor a um novo índice do array.

LuaConsole

local meuArray = {}

meuArray[1] = "Primeiro elemento"
meuArray[2] = "Segundo elemento"
meuArray[3] = "Terceiro elemento"
meuArray[#meuArray + 1] = "Último elemento"

print(meuArray[1])
print(meuArray[2])
print(meuArray[3])
print(meuArray[4])

Primeiro elemento
Segundo elemento
Terceiro elemento
Último elemento

Outra alternativa é utilizar table.insert que está na biblioteca padrão do Lua.

LuaConsole

local meuArray = {}

table.insert(meuArray, "Primeiro elemento")
table.insert(meuArray, "Segundo elemento")
table.insert(meuArray, "Terceiro elemento")
table.insert(meuArray, "Último elemento")

print(meuArray[1])
print(meuArray[2])
print(meuArray[3])
print(meuArray[4])

Primeiro elemento
Segundo elemento
Terceiro elemento
Último elemento

Nesse exemplo, utilizamos a função table.insert() da biblioteca padrão do Lua para adicionar os elementos ao array. A função table.insert() insere um elemento no final do array automaticamente.

Iterando em um array

Em Lua, é possível iterar em um array de diferentes maneiras. Vou mostrar algumas das formas de como percorrer os elementos de um array.

Utilizando o laço for

Um método comum para iterar em um array é usar o laço for juntamente com o operador # para obter o tamanho do array. Aqui está um exemplo:

LuaConsole

local meuArray = {"Primeiro elemento", "Segundo elemento", "Terceiro elemento", "Último elemento"}

for i = 1, #meuArray do
    print(meuArray[i])
end

Primeiro elemento
Segundo elemento
Terceiro elemento
Último elemento

Nesse exemplo, usamos o laço for para iterar de 1 até o tamanho do array `#meuArray. A cada iteração, imprimimos o elemento correspondente ao índice i.

Utilizando a função ipairs()

Outra forma conveniente de iterar em um array é utilizando a função ipairs(), que retorna pares índice-valor. Aqui está um exemplo:

LuaConsole

local meuArray = {"Primeiro elemento", "Segundo elemento", "Terceiro elemento", "Último elemento"}

for i, valor in ipairs(meuArray) do
    print(valor)
end

Primeiro elemento
Segundo elemento
Terceiro elemento
Último elemento

Warning

O lua também disponibiliza outras duas funções, table.foreach e table.foreachi, porém elas foram descontinuadas e não são mais recomendadas para uso

Diferença entre tabelas e outros tipos de dados

Ao contrário de strings, números, booleanos, e valores nulos (nil), as tabelas são mutáveis, o que significa que você pode modificar seus valores.

No entanto, quando se trata de strings, se você tentar alterar o valor de uma string diretamente, nada acontecerá.

LuaConsole

local hello = "Olá, mundo"
string.upper(hello)

print(hello)

Olá, mundo

Isso ocorre porque as strings são consideradas "somente leitura" (read-only). Ao tentar alterar o valor de uma string, na verdade, uma nova string é criada em um novo espaço de memória, mas a variável original não é modificada.

Para efetuar a modificação em uma string e salvar o novo valor na mesma variável, você precisa atribuir o resultado da modificação de volta à variável. Em outras palavras, você precisa atualizar a variável para apontar para o novo endereço de memória onde está armazenada a string modificada.

LuaConsole

local hello = "Olá, mundo"
hello = string.upper(hello)

print(hello)

OLÁ, MUNDO

Com tabelas, não é necessário fazer a atribuição de volta à variável. Ao modificar a tabela, o valor original será alterado. Em outras palavras, ao realizar uma modificação em uma tabela, você está alterando o espaço de memória onde a tabela está armazenada. Não é necessário criar uma nova tabela ou atualizar referências, pois as alterações são feitas diretamente no local de armazenamento da tabela.

LuaConsole

local frutas = {}

local function insert(t, value)
  t[#t + 1] = value

  -- não precisa de return
end

insert(frutas, "Uva")
insert(frutas, "Maça")
insert(frutas, "Laranja")

for key, value in ipairs(frutas) do
  print(key, value)
end

1       Uva
2       Maça
3       Laranja