MATLAB 帮助中心
验证值为负值
mustBeNegative(value)
如果 value 不为负值,mustBeNegative(value) 将抛出错误。小于零的值即为负值。此函数不返回值。
value
mustBeNegative 调用以下函数来确定输入是否为负值:
mustBeNegative
lt
isreal
isnumeric
islogical
支持的类:重载 mustBeNegative 调用的函数的所有数值类、logical 和 MATLAB® 类。
logical
此函数忽略输入参量中的空值。因此,当属性或函数参量值为空时,不会抛出错误。
示例
全部折叠
使用 mustBeNegative 验证输入只包含负值。
rand 函数在区间 (0,1) 内创建均匀分布的随机数。在减法运算后测试数组以验证所有值均为负。否则,mustBeNegative 将引发错误。
rand
(0,1)
A = rand(1,5) - 0.75; mustBeNegative(A)
Value must be negative.
此类将 Prop1 的值限制为负值。
Prop1
classdef MyClass properties Prop1 {mustBeNegative} end end
创建一个对象,并向其 Prop1 赋值。
obj = MyClass; obj.Prop1 = rand(1,5) - 0.75;
Error setting property 'Prop1' of class 'MyClass'. Value must be negative.
当您向属性赋值时,MATLAB 会使用赋给属性的值调用 mustBeNegative。mustBeNegative 将引发错误,因为数组中任何元素的值均不为负。
此函数声明两个输入参量。输入 lower 必须为负数,输入 upper 不能为负数。
lower
upper
function r = mbNegative(lower,upper) arguments lower {mustBeNegative} upper {mustBeNonnegative} end x = lower*pi:upper*pi; r = sin(x); end
使用不满足 mustBeNegative 要求的 lower 值调用该函数会引发错误。
mbNegative(0,4)
Error using mbNegative (line 3) mbNegative(0,4) ^ Invalid argument at position 1. Value must be negative.
要验证的值,指定为标量或由以下任一类型的值组成的数组:
logical 或数值类
实现 lt、isreal 以及 isnumeric 或 islogical 的 MATLAB 类
mustBeNegative 用于属性和函数参量验证。
全部展开
mustBeNegative 函数完全支持 GPU 数组。要在 GPU 上运行该函数,请将输入数据指定为 gpuArray (Parallel Computing Toolbox)。有关详细信息,请参阅在 GPU 上运行 MATLAB 函数 (Parallel Computing Toolbox)。
gpuArray
此函数完全支持分布式数组。有关详细信息,请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。
在 R2017a 中推出
arguments | mustBeNumericOrLogical | mustBeReal | mustBeNonnegative | mustBePositive
arguments
mustBeNumericOrLogical
mustBeReal
mustBeNonnegative
mustBePositive
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
选择网站
选择网站以获取翻译的可用内容,以及查看当地活动和优惠。根据您的位置,我们建议您选择:。
您也可以从以下列表中选择网站:
如何获得最佳网站性能
选择中国网站(中文或英文)以获得最佳网站性能。其他 MathWorks 国家/地区网站并未针对您所在位置的访问进行优化。
美洲
欧洲
亚太
联系您当地的办事处