`validateattributes`

Verifica se um valor tem a classe e as propriedades exigidas, gerando erro caso contrário.

Categoria: Language Fundamentals > Data Types

Sintaxe

validateattributes(A, classes, attributes)

Verifica se A pertence a uma das classes e satisfaz todos os atributos.

validateattributes(A, classes, attributes, argIndex)

Inclui a posição do argumento na mensagem de erro.

Descrição

validateattributes é usada no início de funções para verificar argumentos em uma só linha, em vez de escrever vários if e error. Quando um requisito falha, lança um erro cuja mensagem nomeia o atributo que falhou. Quando tudo é válido, não faz nada e não retorna valor.

Em código novo, os blocos de argumentos (arguments) cobrem as mesmas verificações de forma declarativa.

Argumentos de entrada

A: O valor a testar.
classes: Cell array de nomes de classes permitidas, como {'numeric'}, {'char','string'}; {} permite qualquer classe.
attributes: Cell array de requisitos como 'positive', 'integer', 'scalar', 'vector', 'nonempty', 'size'.

Exemplo

Um valor válido passa em silêncio

validateattributes(5, {'numeric'}, {'positive','integer'});
disp('ok')

Saída

ok

Observações

No MatLivre, validateattributes aceita seus argumentos mas não faz nenhuma verificação e nunca gera erro.

Veja também

validatestring inputParser assert isnumeric narginchk