Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Exceções e limpeza

Erros acontecem — arquivo que não existe, JSON inválido, divisão por zero. Use tente e pegue para lidar com eles sem derrubar o programa, e finalmente para garantir a limpeza.

tente, pegue tipado e finalmente

Use falhar para lançar um erro (texto ou instância de Excecao/subclasse). Você pode ter vários blocos pegue filtrando por tipo de exceção. O bloco finalmente sempre roda — tenha dado certo, dado erro ou executado um retorna.

tente {
    falhar "entrada inválida"
} pegue (erro: Excecao) {
    escreva(erro.mensagem)
} finalmente {
    escreva("limpeza garantida")
}

Erros estáticos dentro de tente/pegue

Quando o compilador prova que uma operação sempre vai falhar (como 1 / 0), ele barra a compilação com E3101. Mas se essa linha estiver dentro de um tente/pegue, ele rebaixa para aviso (W3101) — assim seus testes de tratamento de erro continuam compilando normalmente.

Experimente: 17_excecoes

tente {
    falhar "proposital"
} pegue (erro: Excecao) {
    escreva(erro.mensagem)
} finalmente {
    escreva("limpeza")
}

tente {
    escreva(1 / 0)
} pegue (erro) {
    escreva(erro)
}

Ver exemplo completo e contrato de teste no GitHub

Experimente: 18_finalmente_retorno

funcao obter(): qualquer {
    tente {
        retorna 3
    } finalmente {
        escreva("fim")
    }
}

escreva(obter())
para (var i: numero = 0; i < 2; i++) {
    tente {
        continua
    } finalmente {
        escreva("loop")
    }
}

Ver exemplo completo e contrato de teste no GitHub

Experimente: 19_excecoes_tipadas

classe MeuErro herda Excecao {
}

tente {
    falhar MeuErro("meu erro")
}
pegue (erro: MeuErro) {
    escreva(erro)
}
pegue {
    escreva("outro erro")
}

Ver exemplo completo e contrato de teste no GitHub

Se uma exceção não for capturada por nenhum pegue, o programa encerra com código 1 e exibe o diagnóstico visual R0001 apontando arquivo, linha e coluna.