`error`

Lança um erro, interrompendo o código em execução a menos que seja capturado.

Sintaxe

error(msg)

Lança um erro com a mensagem msg.

error(msg, A1, ..., An)

Formata a mensagem como sprintf antes de lançar.

error(id, msg, A1, ..., An)

Também define o identificador id da mensagem, como 'MyPkg:badInput'.

error(ME)

Lança um objeto MException existente, ou uma struct com os campos message e identifier.

Descrição

error é como o código informa uma situação da qual não pode continuar. Um erro não capturado interrompe o script e imprime a mensagem; dentro de try ... catch, o objeto capturado err tem err.message, err.identifier e err.stack. Identificadores permitem reagir a uma falha específica com strcmp(err.identifier, 'MyPkg:badInput') em vez de comparar o texto da mensagem.

Um único argumento com aparência de identificador, como em error('Result:bad'), é tratado como mensagem e deixa o identificador vazio; informe uma mensagem depois do identificador para definir os dois.

Argumentos de entrada

msg: Texto da mensagem. Campos de formato e sequências de escape como \n só são processados quando há argumentos adicionais.
id: Identificador formado por partes unidas por dois-pontos, sem espaços, com ao menos um dois-pontos.
A1, ..., An: Valores para os campos de formato de msg.
ME: Um objeto MException ou uma struct.

Exemplo

Capturando um erro com identificador

try
    error('Demo:tooBig', 'Value %d is larger than %d', 12, 10);
catch err
    disp(err.identifier)
    disp(err.message)
end

Saída

Demo:tooBig
Value 12 is larger than 10

Veja também

warning assert MException lasterr