`mustBeInRange`

Verifica se todos os elementos estão entre dois limites.

Sintaxe

mustBeInRange(A, lower, upper)

Verifica se todos os elementos de A estão no intervalo de lower a upper. Não retorna nada se a verificação passa e lança um erro se não passa.

mustBeInRange(A, lower, upper, boundflag)

Exclui da faixa o limite inferior, o superior ou ambos, conforme boundflag.

Descrição

mustBeInRange é um validador: examina a entrada e retorna em silêncio ou lança um erro com o identificador MATLAB:validators:mustBeInRange. 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.

Por padrão ambos os limites são permitidos, ou seja, a faixa é o intervalo fechado. A mensagem indica qual lado é aberto, por exemplo que os valores devem ser maiores ou iguais ao limite inferior e menores que o superior.

Argumentos de entrada

A: O valor a verificar. Qualquer array da classe que o validador aceita.
lower: Limite inferior, um escalar real.
upper: Limite superior, um escalar real não menor que lower.
boundflag: Opcional: 'exclusive', 'exclude-lower' ou 'exclude-upper' para deixar um ou ambos os limites fora da faixa permitida.

Exemplo

Entrada válida e inválida

mustBeInRange([1 3 5], 1, 5);
disp('passed')
try
    mustBeInRange(7, 1, 5)
catch err
    disp(err.message)
end

Saída

passed
Value must be greater than or equal to 1, and less than or equal to 5.

Veja também

mustBeGreaterThan mustBeLessThan mustBeNonnegative mustBeMember