matlab.settings.mustBeStringScalar

验证设置值是字符串标量

自 R2019b 起

语法

matlab.settings.mustBeStringScalar(settingvalue)

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

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

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

创建设置组 mysettings。

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

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

addSetting(s.mysettings,'MyStringSetting','ValidationFcn',@matlab.settings.mustBeStringScalar);

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

s.mysettings.MyStringSetting.PersonalValue = 11;

Error setting 'MyStringSetting' in group 'mysettings': 
Value must be string or convertible to string.

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

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

在 R2019b 中推出