mustBeScalarOrEmpty

値がスカラーまたは空であることを検証

R2020b 以降

構文

mustBeScalarOrEmpty(value)

説明

mustBeScalarOrEmpty(value) は、value がスカラーでないか、空でない場合にエラーをスローします。この関数は値を返しません。

mustBeScalarOrEmpty は以下の関数を呼び出して、入力がスカラーまたは空であるかどうかを判別します。

• isscalar

• isempty

例

入力をスカラーまたは空に制限

mustBeScalarOrEmpty を使用して、関数の入力引数で許容される値を制限します。

function v = buildVector(inc)
    arguments
        inc {mustBeScalarOrEmpty}
    end
    v = 1:inc:10;
end

非スカラーを関数 buildVector に渡すとエラーになります。

v = buildVector([1 2]);

Error using buildVector
 v = buildVector([1 2]);
                 ↑
Invalid argument at position 1. Value must be scalar.

入力引数

value — 検証する値

スカラー | 空

検証する値。スカラーまたは空の値として指定します。スカラーでない値または空でない値はエラーになります。

例: []

ヒント

• mustBeScalarOrEmpty は、プロパティと関数の引数の検証で使用されるように設計されています。

拡張機能

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

この関数は GPU 配列を完全にサポートしています。詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2020b で導入

参考

arguments | mustBeNonempty

トピック

• 関数の引数の検証
• プロパティの検証関数