Lançando um erro

Às vezes, uma função encontra uma situação que não consegue tratar, como um arquivo ausente ou uma entrada inválida. O Mojo permite sinalizar isso com um erro. ⚠️

Para sinalizar uma falha, use a palavra-chave raise. Ela interrompe o trabalho atual e informa que algo deu errado.

Ao usar raise, você passa uma pequena mensagem descrevendo o problema. Quem tratar o erro poderá ler esse texto.

Uma função pode usar raise quando sua entrada é inválida. Aqui, uma quantidade negativa é rejeitada antes que qualquer trabalho adicional aconteça.

Quando raise é executado, o restante da função é ignorado. O controle sai dela procurando código capaz de lidar com o erro.

É fácil ignorar um valor especial como -1. Um erro não pode ser ignorado silenciosamente, tornando as falhas muito mais difíceis de não perceber.

Um erro não tratado continua subindo pelos chamadores até que algo o capture. Isso é chamado de propagação.

Gerar um erro imediatamente ao receber uma entrada inválida é um bom hábito. Verifique os valores primeiro e use raise antes que a lógica principal seja executada.

Dê a cada raise uma mensagem clara e específica. Uma boa descrição transforma uma falha em uma pista útil para quem a depura.

Um erro gerado é um sinal estruturado, não uma falha aleatória. Seu programa pode se recuperar dele em vez de simplesmente ser encerrado.

A regra prática é: use raise somente quando uma função realmente não puder concluir sua tarefa corretamente. Não o use para resultados normais.

Você aprendeu a sinalizar falhas com raise, anexar uma mensagem clara e deixar que os erros interrompam operações inválidas, em vez de retornar valores especiais. 🎯