主要内容

参数定义

接受可变数量的输入或输出,检查有效值

由于MATLAB®是一种非类型化语言,大多数函数不需要参数声明或验证。但是,如果函数的使用范围很广,并且需要验证输入的类型、大小或其他方面,以确保代码按预期工作,则可以定义参数块(因为R2019b)。有关详细信息,请参见函数参数验证

此外,您还可以检查函数接收多少输入或输出、输入变量的名称等等。

功能

全部展开

参数块

参数 声明函数参数验证

数值验证

mustBePositive 确认该值为正
mustBeNonpositive 确认该值是非正数
mustBeNonnegative 验证该值是非负的
mustBeNegative 确认该值为负值
mustBeFinite 验证该值是有限的
mustBeNonNan 验证该值不是NaN
mustBeNonzero 验证该值是否为非零
mustBeNonsparse 验证该值是非稀疏的
mustBeReal 确认该值是真实的
mustBeInteger 验证该值为整型
mustBeNonmissing 验证该值是否丢失

比较

mustBeGreaterThan 验证该值大于另一个值
mustBeLessThan 验证该值小于另一个值
mustBeGreaterThanOrEqual 验证该值是否大于或等于另一个值
mustBeLessThanOrEqual 验证该值小于或等于另一个值

数据类型

mustBeA 验证该值来自指定的类之一
mustBeNumeric 验证该值是数值
mustBeNumericOrLogical 验证该值是数值还是逻辑值
mustBeFloat 验证该值是浮点数组
mustBeText 验证该值是字符串数组、字符向量或字符向量的单元格数组
mustBeTextScalar 验证该值是一段文本
mustBeNonzeroLengthText 验证该值是长度非零的文本
mustBeUnderlyingType 验证该值已指定基础类型

大小

mustBeNonempty 验证该值是非空的
mustBeScalarOrEmpty 验证该值为标量或空
mustBeVector 验证该值是否为vector

范围和集合成员

mustBeInRange 验证该值是否在指定范围内
mustBeMember 验证该值是指定集合的成员

的名字

mustBeFile 验证路径指向文件
mustBeFolder 验证输入路径是否指向文件夹
mustBeValidVariableName 验证输入名称是否是有效的变量名称

名称-值参数结构

namedargs2cell 将包含名称-值对的结构转换为单元格数组

输入

变长度输入宗量 可变长度的输入参数列表
输入参数个数 函数输入参数的个数
narginchk 验证输入参数的数量

输出

varargout 可变长度输出参数列表
nargout 函数输出参数的个数
nargoutchk 验证输出参数的数量
validateattributes 数组有效性检查
validatestring 检查文本的有效性
validatecolor 验证颜色值
inputname 函数输入的变量名
mfilename 当前运行代码的文件名
inputParser 函数输入解析器

主题

参数值

解析函数输入的方法

选择一种检查输入参数有效性的技术。

函数参数验证

声明输入参数的类和大小,并对参数值施加限制。

用validateattribute检查函数输入

这个示例展示了如何使用validateattributes函数。

解析函数的输入

定义必需和可选输入,为可选输入指定默认值,并使用Input Parser验证自定义函数的所有输入。

数量的参数

金宝app支持可变的输入数量

使用命令定义一个接受可变数量输入参数的函数变长度输入宗量.的变长度输入宗量参数是包含函数输入的单元格数组,其中每个输入位于其自己的单元格中。

金宝app支持可变数量的输出

使用命令定义一个返回可变数量输出参数的函数varargout.输出varargout是包含函数输出的单元格数组,其中每个输出位于其自己的单元格中。

查找函数参数的个数

使用输入参数个数nargout确定函数接收多少输入或输出参数。

直通输入

忽略函数定义中的输入

如果您的函数接受一组预定义的输入,但没有使用所有的输入,请使用波浪号()操作符以在函数定义中忽略它们。