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 tanto a sintaxe de ponto quanto a de dois-pontos, é fundamental entender quando usar cada uma e o que acontece quando você as mistura incorretamente.

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

Veja o que acontece quando você os combina incorretamente:

local game = { score = 0 }

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

-- WRONG: 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), Lua não passa game automaticamente. O valor 10 se torna self, causando comportamento inesperado ou erros.

A direção inversa é mais permissiva:

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

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

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

Desafio

Fácil

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

Adicione duas funções à tabela:

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

Você receberá duas entradas:

Um valor de pontuação inicial
Uma quantidade de bônus a adicionar

Execute as seguintes etapas:

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

Lembre-se: corresponda a forma como você chama cada função à 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


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