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

入力引数

sectionObj — ターゲットのデータ ディクショナリ セクション

Simulink.data.dictionary.Section オブジェクト

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

entryName — ターゲットのエントリの名前

文字ベクトル

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

例: 'myEntry'

データ型: char

出力引数

doesExist — エントリがあるかどうかを示す値

0 | 1

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

ヒント

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

代替方法

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

バージョン履歴

R2015a で導入

参考

Simulink.data.dictionary.Section | find | Simulink.data.existsInGlobal

トピック

• プログラムによるディクショナリへのデータの格納