`mustBeA`

Verifica se um valor pertence a uma das classes indicadas.

Sintaxe

mustBeA(A, classname)

Verifica se A é da classe indicada ou herda dela. Não retorna nada se a verificação passa e lança um erro se não passa.

Descrição

mustBeA é um validador: examina a entrada e retorna em silêncio ou lança um erro com o identificador MATLAB:validators:mustBeA. A mensagem de erro informa o requisito violado, de modo que quem chama vê o que era esperado em vez de uma falha genérica.

O teste é isa(A, classname), então uma subclasse da classe indicada também passa. Com vários nomes, o valor é aceito se for de qualquer um deles.

Argumentos de entrada

A: O valor a verificar. Qualquer array da classe que o validador aceita.
classname: Nome da classe como texto, ou cell array ou array de strings com nomes. O valor passa se corresponder a algum deles.

Exemplo

Entrada válida e inválida

mustBeA(5, 'double');
disp('passed')
try
    mustBeA(5, 'char')
catch err
    disp(err.message)
end

Saída

passed
Value must be one of the following types: 'char'.

Veja também

isa class mustBeNumeric mustBeText