validateattributes

📝Syntaxe

validateattributes(A, classes, attributes)
validateattributes(A, classes, attributes, argIndex)
validateattributes(A, classes, attributes, funcName)
validateattributes(A, classes, attributes, funcName, varName)
validateattributes(A, classes, attributes, funcName, varName, argIndex)

📥Arguments d'entrée

Paramètre	Description
A	tableau ou objet a verifier.
classes	noms de classes acceptes, sous forme de vecteur de caracteres, tableau de chaines ou cellule de vecteurs de caracteres.
attributes	attributs requis, sous forme de cellule ou tableau de chaines. Les attributs qui demandent une valeur doivent etre suivis immediatement par cette valeur.
argIndex	entier positif utilise dans les messages d'erreur pour indiquer la position de l'argument.
funcName	nom de fonction utilise dans les identifiants d'erreur generes.
varName	nom de variable utilise dans les messages d'erreur generes.

📄Description

validateattributes emet une erreur si A n'appartient pas a au moins une classe demandee ou ne satisfait pas tous les attributs demandes. La fonction ne renvoie aucune sortie lorsque la verification reussit.

classes accepte les noms de classes concretes et les noms de classes personnalisees testes avec isa. Les alias numeric, integer et float sont aussi pris en charge.

Les attributs de forme pris en charge sont 2d, 3d, column, row, scalar, scalartext, vector, square, diag, nonempty et nonsparse.

Les attributs de taille avec valeur sont size, numel, ncols, nrows et ndims. Pour size, utilisez NaN dans une dimension attendue pour ignorer cette dimension.

Les attributs de valeur pris en charge sont finite, nonnan, binary, even, odd, integer, real, nonnegative, nonpositive, negative, nonzero et positive.

Les attributs de plage sont >, >=, < et <=. La valeur de comparaison doit suivre le nom de l'attribut.

Les attributs de monotonie sont decreasing, increasing, nondecreasing et nonincreasing. La monotonie est verifiee colonne par colonne.

💡Exemples

Verifier une classe, une forme et des valeurs.

validateattributes([1 2 3], {'numeric'}, {'row', 'vector', 'positive'})

Verifier une taille partiellement specifiee.

A = ones(2, 3, 4);
validateattributes(A, {'numeric'}, {'3d', 'size', [2 NaN 4], 'ndims', 3})

Verifier la monotonie colonne par colonne.

A = [1 4; 2 4; 3 5];
validateattributes(A, {'numeric'}, {'nondecreasing'})

Utiliser la verification dans un analyseur d'entrees.

p = inputParser();
addRequired(p, 'name', @(x) validateattributes(x, {'char'}, {'nonempty'}));
addOptional(p, 'id', 1, @(x) validateattributes(x, {'numeric'}, {'scalar', 'positive'}));
parse(p, 'item', 3);
p.Results