主要内容

validateString.

检查文本的有效性

描述

matchedstr.= ValidateString(str.validstrings.检查有效性str.反对validstrings.。如果它是任何元素是一个明确的,不区分大小写的匹配项,文本有效validstrings.。该validateString.函数支持前导字符的万博1manbetx部分匹配。

如果str.有效,然后validateString.返回匹配的文本。否则,matlab.®抛出错误。

matchedstr.= ValidateString(str.validstrings.argidx.包括函数参数列表中的输入的位置,作为任何生成的错误消息的一部分。使用此语法格式化任何生成的错误消息。

matchedstr.= ValidateString(str.validstrings.funcname.在生成的错误标识符中包含指定的函数名称。

matchedstr.= ValidateString(str.validstrings.funcname.arnamame.在生成的错误消息中包含指定的变量名称。使用此语法格式化任何生成的错误消息。

matchedstr.= ValidateString(str.validstrings.funcname.arnamame.argidx.包括函数参数列表中的输入的位置,作为任何生成的错误消息的一部分。使用此语法格式化任何生成的错误消息。

例子

全部收缩

检查字符串是否处于一组有效值。

validstrings = [“风”“奇迹”“什么时候”];str =“风”;validstr = validatestring(str,validstrings)
validstr =“风”

检查是否“韩元”是在由此定义的有效值集中validstrings.。该字符串是不区分大小写的,部分匹配“奇迹”

str =“韩元”;validstr = validatestring(str,validstrings)
validstr =“奇迹”

如果存在多个部分匹配,并且每个字符串不是另一个字符串,那么validateString.抛出错误。

validstrings = [“展示”“出现”“showtimes”];str =“节目”;validstr = validatestring(str,validstrings)
预期的输入匹配其中一个值:'showcase','show up','showtimes'输入,显示,显示,匹配多个有效值。

但是,如果存在多个部分匹配,并且每个字符串是另一个字符串,那么validateString.返回最短的比赛。

validstrings = [“右转”“对”“正义”];str =“钻机”;validstr = validatestring(str,validstrings)
validstr =“右”

在命名的文件中创建一个函数Findarea.m.。验证形状包括函数参数列表中的输入的位置,作为任何生成的错误消息的一部分。验证单位还包括变量名('单位')在错误消息和错误标识符中的文件名中。使用mfilename.功能查找文件名。

功能a = findarea(形状,h,w,单位)的预期= {'广场''长方形''三角形'};预期= {'厘米''M''在''ft''yds'};Shapename = ValidateString(形状,预示,1);Unitleabbrev = ValidateString(单位,设施,mfilename,'单位'4);开关Shapename.案件{'广场''长方形'a = h * w;案件{'三角形'a = h * w / 2;除此以外错误(“未知形状通过验证。”结束结束

用有效的形状名称调用函数。的价值'rect'是有效的,因为它是一个不区分大小写的部分匹配'长方形'

a = findarea('rect',10,3,'厘米'
a = 30.

使用无效的形状名称调用函数。错误消息包含无效文本的位置。这里,无效文本是第一个输入参数。

a = findarea('八角形',7,13,'在'
使用FindArea(第5行)预期输入数字1匹配其中一个值:'Square','矩形','三角形'输入,'OctAgen',与任何有效值不匹配。

使用无效单元调用函数。错误消息包含变量名称和无效文本的位置。无效文本是第四个输入参数。

a = findarea('三',10,3,'mi'
使用findarea(第6行)预期输入数字4,单位,匹配其中一个值:'cm','m','','ft','yds'输入,'mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi','mi',与'mi')不匹配任何有效值。

采用mexception.查看错误标识符,包括文件名。

id = mexception.last.identifier.
id ='matlab:findarea:unrecognizedstringchoice'

输入参数

全部收缩

要验证的文本,指定为字符串标量或字符向量。

例:'texttovalidation'

例:“overtextovalidative”

要匹配的文本,指定为字符串数组或字符向量的单元格数组。

例:[“Value1”,“Value2”]

例:{'val1','val2',val3'}

函数的名称,其输入验证,指定为字符串标量或字符向量。如果您指定空字符向量''或者<缺失>字符串,然后是validateString.功能忽略了funcname.输入。

例:“myfunctionname”

例:拨电至mfilename.函数,如在代码中ValidateString(单位,预示,Mfilename)

要验证的输入变量的名称,指定为字符串标量或字符向量。如果您指定空字符向量''或者<缺失>字符串,然后是validateString.功能忽略了arnamame.输入。

例:“InputVarifee1”

例:'变量'

输入参数的位置验证,指定为正整数。

输出参数

全部收缩

匹配的文本,返回字符串标量如果validstrings.如果是字符串数组,或者是字符矢量validstrings.是一个细胞阵列的字符向量。

示例 - 匹配''和。。。 返回值 匹配类型
谷仓 完全符合
气球谷仓 气球 部分匹配(前导字符)
鲍尔科芭蕾舞气球 鲍尔科(最短的比赛) 每个字符向量是另一个字符向量的多个部分匹配
气球芭蕾舞 错误 多个部分匹配唯一的字符向量
谷仓 错误 没有匹配

扩展能力

介绍在R2006B.