validatestring
Verifie qu'un texte correspond a une valeur autorisee.
📝Syntaxe
matched = validatestring(str, validStrings)
matched = validatestring(str, validStrings, argIndex)
matched = validatestring(str, validStrings, funcName)
matched = validatestring(str, validStrings, funcName, varName)
matched = validatestring(str, validStrings, funcName, varName, argIndex)
📥Arguments d'entrée
Paramètre Description
str texte a verifier, sous forme de vecteur de caracteres ou chaine scalaire.
validStrings valeurs de texte autorisees, sous forme de vecteur de caracteres, tableau de chaines ou cellule de vecteurs de caracteres.
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.
📤Arguments de sortie
Paramètre Description
matched valeur trouvee dans validStrings. La sortie est une chaine scalaire si validStrings est un tableau de chaines ; sinon c'est un vecteur de caracteres.
📄Description

validatestring accepte les correspondances exactes et les correspondances partielles de debut de texte, sans tenir compte de la casse. Les correspondances exactes sont prioritaires.

Si une seule correspondance partielle existe, cette valeur est renvoyee. Si plusieurs correspondances partielles existent et que toutes les valeurs correspondantes forment une chaine de sous-chaines, la valeur la plus courte est renvoyee. Sinon une erreur d'ambiguite est emise.

Les messages d'erreur peuvent inclure une position d'argument, un nom de variable et un nom de fonction selon la syntaxe utilisee.

💡Exemples
Correspondances exactes et partielles sans tenir compte de la casse.
shape = validatestring('Rect', {'square', 'rectangle', 'triangle'});
direction = validatestring("LEFT", ["left", "right"])
Correspondance la plus courte dans une chaine de correspondances partielles.
value = validatestring('rig', {'righteously', 'right', 'righteous'})
Utiliser les arguments de contexte pour les erreurs generees.
units = {'cm', 'm', 'in', 'ft'};
choice = validatestring('CM', units, 'findArea', 'units', 4)
🔗Voir aussi
validateattributesinputParser
🕔Historique des versions
Version Description
1.0.0 version initiale
Modifier cette page sur GitHub