O Metamétodo __tostring

Quando você imprime uma tabela em Lua, normalmente vê algo pouco útil, como table: 0x5f8a20, apenas um endereço de memória. O metamétodo __tostring permite alterar esse comportamento, definindo exatamente o que deve ser exibido quando sua tabela é convertida em uma string.

Este metamétodo é particularmente útil para depuração e para criar uma saída mais limpa. Quando o Lua precisa converter sua tabela em uma string (como ao usar print()), ele verifica se a tabela tem uma metatabela com um campo __tostring. Se tiver, o Lua chama essa função e usa o valor retornado por ela em vez da representação padrão.

Veja como implementá-lo:

local vector = {x = 3, y = 4}
local meta = {
    __tostring = function(t)
        return "Vector(" .. t.x .. ", " .. t.y .. ")"
    end
}

setmetatable(vector, meta)

print(vector)  -- Saída: Vector(3, 4)

A função __tostring recebe a tabela como seu argumento e deve retornar uma string. Neste exemplo, ela constrói uma string formatada que mostra os valores x e y do vetor em um formato legível.

Isso torna seu código muito mais fácil de trabalhar. Em vez de ver endereços de memória enigmáticos durante a depuração, você obtém informações significativas sobre o que sua tabela contém.