mustBeNonempty

値が空でないことを検証

構文

mustBeNonempty(value)

説明

mustBeNonempty(value) は、value が空である場合にエラーをスローします。この関数は値を返しません。

mustBeNonempty は以下の関数を呼び出して、入力が空でないかどうかを判別します。

• isempty

クラス サポート: すべての MATLAB^® クラス

例

入力が空でないことを検証

mustBeNonempty を使用して、入力が空でないことを検証します。

containers.Map を作成します。

A = containers.Map;

A が空の値でないことを検証します。

mustBeNonempty(A)

Value must not be empty.

入力引数がない containers.Map を作成すると、空のオブジェクトが生成されます。

プロパティ値の制限

このクラスは、Prop1 の値を空でない値に制限します。既定値も空でない値にしなければなりません。

classdef MyClass
   properties
      Prop1 {mustBeNonempty} = containers.Map(1,'First')
   end
end

オブジェクトを作成して、プロパティに値を割り当てます。

obj = MyClass;
obj.Prop1 = containers.Map;

Error setting 'Prop1' property of 'MyClass' class. Value must not be empty.

プロパティに値を割り当てると、MATLAB はプロパティに割り当てた値を使用して mustBeNonempty を呼び出します。Prop1 に割り当てられた値が空であるため、mustBeNonempty はエラーを発行します。

関数の引数値の制限

この関数は、入力引数を空でない文字ベクトルに制限します。

function str = mbNonempty(name)
    arguments
        name (1,:) char  {mustBeNonempty}
    end
    str = sprintf('Name: %s',name);
end

空の文字ベクトルを指定してこの関数を呼び出すと、mustBeNonempty によってエラーがスローされます。

mbNonempty('')

Error using mbNonempty (line 3)
 mbNonempty('')
            ^^
Invalid argument at position 1. Value must not be empty.

入力引数

value — 検証する値

スカラー | 配列

検証する値。スカラーまたは任意の MATLAB 型またはクラスの配列として指定します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | struct | table | cell | function_handle | categorical | datetime | duration | calendarDuration
複素数のサポート: あり

ヒント

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

拡張機能

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

GPU 配列

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

mustBeNonempty 関数は、GPU 配列を完全にサポートします。GPU 上で関数を実行するには、入力データを gpuArray (Parallel Computing Toolbox) として指定します。詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

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

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

バージョン履歴

R2017a で導入

参考

arguments | isempty | mustBeNonzero | mustBeMember

トピック

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