mustBeNonnegative

Verifica se todos os elementos são maiores ou iguais a zero.

Categoria: Programming > Functions

Sintaxe

mustBeNonnegative(A)

Verifica se todos os elementos de A são maiores ou iguais a zero. Não retorna nada se a verificação passa e lança um erro se não passa.

Descrição

mustBeNonnegative é um validador: examina a entrada e retorna em silêncio ou lança um erro com o identificador MATLAB:validators:mustBeNonnegative. 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 zero passa. Use mustBePositive quando o zero precisar ser excluído.

Argumentos de entrada

A
O valor a verificar. Qualquer array da classe que o validador aceita.

Exemplo

Entrada válida e inválida

mustBeNonnegative([0 2 5]);
disp('passed')
try
    mustBeNonnegative(-1)
catch err
    disp(err.message)
end
Saída
passed
Value must be nonnegative.

Veja também

mustBePositive mustBeNonpositive mustBeGreaterThanOrEqual mustBeInteger