`mustBeScalarOrEmpty`

Verifica se um valor tem um único elemento ou nenhum.

Sintaxe

mustBeScalarOrEmpty(A)

Verifica se A é um escalar ou está vazio. Não retorna nada se a verificação passa e lança um erro se não passa.

Descrição

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

Útil para argumentos opcionais, em que [] significa 'não informado' e um escalar significa 'use este valor'.

Argumentos de entrada

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

Exemplo

Entrada válida e inválida

mustBeScalarOrEmpty(5);
disp('passed')
try
    mustBeScalarOrEmpty([1 2])
catch err
    disp(err.message)
end

Saída

passed
Value must be scalar or empty.

Veja também

isscalar isempty mustBeNonempty mustBeVector