matlab.settings.mustBeIntegerScalar

設定値が整数スカラーであることの検証

R2019b 以降

構文

matlab.settings.mustBeIntegerScalar(settingvalue)

matlab.settings.mustBeIntegerScalar(settingvalue) は、settingvalue が整数スカラーでない場合にエラーを発行します。この関数は値を返しません。

この関数は空の値である入力引数を無視します。そのため、設定値が空の場合にはエラーがスローされません。

設定を作成し、設定値が整数スカラーであることを検証する関数を指定します。

設定グループ mysettings を作成します。

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

設定 MyIntegerSetting を mysettings に追加して、検証関数 matlab.settings.mustBeIntegerScalar を指定します。

addSetting(s.mysettings,'MyIntegerSetting','ValidationFcn',@matlab.settings.mustBeIntegerScalar);

検証関数をテストします。MyIntegerSetting の値を非整数値に設定します。予想どおり、MATLAB^® はエラーをスローします。

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

Error setting 'MyIntegerSetting' in group 'mysettings': Value must be integer.

検証する設定値。次のいずれかのスカラーとして指定します。

logical、char または数値クラス
isnumeric または islogical と、isscalar、isreal、isfinite、floor および eq のいずれかを実装する MATLAB クラス

他のデータ型の場合、エラーが発生します。

R2019b で導入