`MException`

Cria um objeto de exceção que carrega um identificador e uma mensagem.

Categoria: Programming > Programming Utilities

Sintaxe

ME = MException(errID, msg)

Cria uma exceção com o identificador errID e a mensagem msg.

ME = MException(errID, msg, A1, ..., An)

Formata a mensagem como sprintf com os argumentos extras.

Descrição

Criar o objeto não gera erro; use throw(ME) para isso. Montar a exceção separadamente é útil para prepará-la, adicionar causas ou guardá-la para depois. Exceções capturadas por catch ME são o mesmo tipo de objeto, então o código pode inspecionar ME.identifier para decidir o que fazer e ME.message para mostrar ao usuário.

Argumentos de entrada

errID: Identificador no formato componente:mnemonico, sem espaços.
msg: Texto da mensagem, possivelmente com conversões como %d e %s.

Argumentos de saída

ME: Um objeto MException com as propriedades identifier, message, cause, stack e Correction.

Exemplo

Criando e lançando uma exceção

ME = MException('app:range', 'Value %d is too large', 99);
try
    throw(ME)
catch e
    disp(e.identifier)
    disp(e.message)
end

Saída

app:range
Value 99 is too large

Veja também

throw rethrow error try, catch addCause