`mustBeMember`

Verifica se um valor é um dos elementos de um conjunto.

Sintaxe

mustBeMember(A, S)

Verifica se A é membro do conjunto S. Não retorna nada se a verificação passa e lança um erro se não passa.

Descrição

mustBeMember é um validador: examina a entrada e retorna em silêncio ou lança um erro com o identificador MATLAB:validators:mustBeMember. 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 é all(ismember(A, S)). Em caso de falha, a mensagem imprime o conjunto inteiro, um valor por linha, o que facilita ver as opções permitidas.

Argumentos de entrada

A: O valor a verificar. Qualquer array da classe que o validador aceita.
S: Os valores permitidos: um array numérico, um vetor de caracteres ou um cell array de vetores de caracteres.

Exemplo

Entrada válida e inválida

mustBeMember('b', {'a', 'b'});
disp('passed')
try
    mustBeMember(4, [1 2 3])
catch err
    disp(err.message)
end

Saída

passed
Value must be a member of this set:
    1
    2
    3

Veja também

ismember validatestring mustBeInRange mustBeA