matlab.settings.mustBeNumericScalar

验证设置值是数值标量

自 R2019b 起

语法

matlab.settings.mustBeNumericScalar(settingvalue)

如果 settingvalue 不是数值标量，则 matlab.settings.mustBeNumericScalar(settingvalue) 会引发错误。此函数不返回值。

此函数忽略输入参量中的空值。因此，当设置值为空时，不会引发错误。

创建一个设置，并指定函数来验证设置值为数值标量。

创建设置组 mysettings。

s = settings;
addGroup(s,'mysettings');

将 MyNumericSetting 设置添加到 mysettings 中，并指定验证函数 matlab.settings.mustBeNumericScalar。

addSetting(s.mysettings,'MyNumericSetting','ValidationFcn',@matlab.settings.mustBeNumericScalar);

测试验证函数。将 MyNumericSetting 的值设置为非数值。与预期相符，MATLAB^® 引发了错误。

s.mysettings.MyNumericSetting.PersonalValue = 'Hello';

Error setting 'MyNumericSetting' in group 'mysettings': Value must be numeric.

要验证的设置值，指定为以下标量之一：

其他数据类型会导致错误。

在 R2019b 中推出