Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

参数定义

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

由于 MATLAB® 是一种非类型化语言,大多数函数都不需要参数声明或验证。但是,如果您的函数有广泛的用途,并且您需要验证输入的类型、大小或其他方面以确保代码按预期工作,您可以定义一个 arguments 代码块(从 R2019b 开始)。有关详细信息,请参阅函数参量验证

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

函数

全部展开

参数块

arguments声明函数参数验证 (自 R2019b 起)

数值验证

mustBePositive验证值为正
mustBeNonpositive验证值为非正
mustBeNonnegative验证值为非负值
mustBeNegative验证值为负值
mustBeFinite验证值是有限值
mustBeNonNan验证值不是 NaN
mustBeNonzero验证值为非零
mustBeNonsparse验证值为非稀疏值
mustBeSparseValidate that value is sparse (自 R2023b 起)
mustBeReal验证值是实数
mustBeInteger验证值为整数
mustBeNonmissing验证值未缺失 (自 R2020b 起)

比较

mustBeGreaterThan验证值大于另一个值
mustBeLessThan验证值小于另一个值
mustBeGreaterThanOrEqual验证值大于等于另一个值
mustBeLessThanOrEqual验证值小于等于另一个值

数据类型

mustBeA验证值来自指定的类之一 (自 R2020b 起)
mustBeNumeric验证值为数值
mustBeNumericOrLogical验证值为数值或逻辑值
mustBeFloat验证值是浮点数组 (自 R2020b 起)
mustBeText验证值是字符串数组、字符向量或字符向量元胞数组 (自 R2020b 起)
mustBeTextScalar验证值是一段文本 (自 R2020b 起)
mustBeNonzeroLengthText验证值为非零长度的文本 (自 R2020b 起)
mustBeUnderlyingType验证值具有指定的基础类型 (自 R2020b 起)

大小

mustBeNonempty验证值为非空
mustBeScalarOrEmpty验证值是标量或为空 (自 R2020b 起)
mustBeVector验证值为向量 (自 R2020b 起)

范围和集合关系

mustBeInRange验证值在指定范围内 (自 R2020b 起)
mustBeMember验证值是指定集的成员

名称

mustBeFile验证路径指向文件 (自 R2020b 起)
mustBeFolder验证输入路径指向文件夹 (自 R2020b 起)
mustBeValidVariableName验证输入名称是有效的变量名称 (自 R2020b 起)

名称-值参数结构体

namedargs2cell将包含名称-值对组的结构体转换为元胞数组 (自 R2019b 起)

输入

varargin可变长度输入参数列表
nargin函数输入参数数目
narginchk验证输入参数数目

输出

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

主题

参数验证

参数数量

直通输入

  • 忽略函数定义中的输入
    如果函数接受一组预定义的输入,但不使用所有输入,请使用波浪号 (~) 运算符忽略函数定义中的输入。