Ponto vs Dois-pontos

Parte da seção Programação Orientada a Objetos do Journey de Lua da Coddy — lição 4 de 70.

Agora que você conhece as sintaxes de ponto e de dois pontos, é crucial entender quando usar cada uma — e o que acontece quando você as mistura incorretamente.

A regra principal é simples: como você define uma função deve corresponder a como você a chama. Se você definir com dois pontos, chame com dois pontos. Se você definir com um ponto e um self explícito, chame com um ponto e passe a tabela.

Aqui está o que acontece quando você os combina incorretamente:

local game = { score = 0 }

function game:addPoints(points)
    self.score = self.score + points
end

-- ERRADO: chamando com ponto, mas nenhuma tabela foi passada
game.addPoints(10)  -- Erro! self agora é 10, não a tabela

Quando você chama game.addPoints(10), o Lua não passa automaticamente game. O valor 10 torna-se self, causando comportamentos inesperados ou erros.

A direção inversa é mais flexível:

function game.reset(self)
    self.score = 0
end

-- Chamada com dois pontos: game:reset() é o mesmo que game.reset(game)
game:reset()  -- self recebe game corretamente, então isso funciona

Embora este caso específico possa funcionar, ele cria confusão e pode quebrar funções que esperam argumentos específicos. A abordagem mais segura é manter a consistência: use dois-pontos tanto para a definição quanto para a chamada quando a função precisar de self, e use o ponto quando não precisar.

Desafio

Fácil

Crie uma tabela chamada player com um campo score inicializado como 0.

Adicione duas funções à tabela:

player.setScore(self, value) - definida com a sintaxe de ponto e o parâmetro explícito self. Define self.score para o valor fornecido.
player:addBonus(amount) - definida com a sintaxe de dois pontos. Adiciona amount ao self.score.

Você receberá duas entradas:

Um valor de pontuação inicial
Um valor de bônus para adicionar

Realize os seguintes passos:

Chame setScore usando a sintaxe de ponto (passando a tabela como o primeiro argumento) para definir a pontuação inicial
Chame addBonus usando a sintaxe de dois pontos para adicionar o bônus
Imprima o valor final de player.score

Lembre-se: faça a correspondência de como você chama cada função com a forma como ela foi definida.

Experimente você mesmo

-- Ler entrada
local initialScore = tonumber(io.read())
local bonusAmount = tonumber(io.read())

-- TODO: Escreva seu código abaixo
-- 1. Crie uma tabela chamada 'player' com um campo 'score' inicializado com 0
-- 2. Adicione player.setScore(self, value) usando a sintaxe de ponto com self explícito
-- 3. Adicione player:addBonus(amount) usando a sintaxe de dois pontos
-- 4. Chame setScore usando a sintaxe de ponto (passando a tabela como primeiro argumento)
-- 5. Chame addBonus usando a sintaxe de dois pontos


-- Exibir a pontuação final
print(player.score)