exist

データ ディクショナリ エントリがあるかどうかをチェック

ページ内をすべて折りたたむ

構文

doesExist = exist(sectionObj,entryName)

説明

doesExist = exist(sectionObj,entryName) は、entryName で指定された名前のエントリがデータ ディクショナリ セクション sectionObj に含まれているかどうかを判定し、その結果を返します。

例

例

すべて折りたたむ

データ ディクショナリにエントリがあるかどうかをエントリの名前を検索して確認します。

データ ディクショナリ myDictionary_ex_API.sldd の [Design Data] セクションを dDataSectObj という名前の Simulink.data.dictionary.Section オブジェクトで表します。

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');
dDataSectObj = getSection(myDictionaryObj,'Design Data');

myDictionary_ex_API.sldd の [Design Data] セクションにエントリ fuelFlow があるかどうかを確認します。

exist(dDataSectObj,'fuelFlow')
ans =

     1

myDictionary_ex_API.sldd の [Design Data] セクションにエントリ myEntry があるかどうかを確認します。

exist(dDataSectObj,'myEntry')
ans =

     0

入力引数

すべて折りたたむ

ターゲットのデータ ディクショナリ セクション。Simulink.data.dictionary.Section オブジェクトとして指定します。この関数を使用する前に、関数 getSection などを使用してターゲットのセクションを Simulink.data.dictionary.Section オブジェクトで表しておきます。

ターゲットのエントリの名前。文字ベクトルとして指定します。

例: 'myEntry'

データ型: char

出力引数

すべて折りたたむ

エントリがあるかどうかを示す値。エントリがない場合は 0、ある場合は 1 が返されます。

ヒント

  • exist では、一致するエントリが参照データ ディクショナリの同じセクションにあるかどうかも判定されます。たとえば、sectionObj がデータ ディクショナリ myDictionary_ex_API.sldd の [Design Data] セクションを表す場合、exist は、myDictionary_ex_API.sldd の [Design Data] セクションに加え、myDictionary_ex_API.sldd が参照しているディクショナリの [Design Data] セクションも検索します。

代替方法

  • Simulink.data.DataConnection オブジェクト関数を使用して、指定した変数がデータ ディクショナリ内に存在するかどうかを判別します。

    dd = Simulink.data.connect("myDictionary.sldd");
dd.a = 1;
dd.c = 3;
exist(dd,["a" "b" "c"])

    ans = 

  1×3 logical array

   1   0   1

  • モデル エクスプローラーを使用して、データ ディクショナリ内のエントリを検索することができます。

バージョン履歴

R2015a で導入

参考

| | | |

トピック