Simulink.data.dictionary.Entry

データ ディクショナリ エントリを設定

このページをすべて展開する

説明

Simulink.data.dictionary.Entry クラスのオブジェクトはデータ ディクショナリの 1 つのエントリを表します。このオブジェクトを使用して、エントリへの値の代入やエントリの名前の変更などの操作を実行できます。

メモ

モデル ワークスペース、Simulink® データ ディクショナリ ([Design Data] セクション)、または MAT ファイルが関連するほとんどの一般的なデータ管理タスクでは、データ ソース固有の関数ではなく、Simulink.data.DataConnection オブジェクトで提供される関数を使用することをお勧めします。これらのオブジェクト関数は、より少ない行数のコードでデータを管理するための共通のコマンド ライン インターフェイスを提供します。Simulink.data.connect 関数を使用してデータ ソースへの接続を作成してから、Simulink.data.DataConnection オブジェクトで提供される一連の共通の関数を使用します。データ ソース固有のタスク (参照データ ディクショナリの削除や追加など) の場合は、データ ソース固有のオブジェクトを作成してから、そのオブジェクトで提供される関数を使用してデータ ソースを管理します。詳細については、Manage Design Data for Simulink Models Programmaticallyを参照してください。

新しい Simulink.data.dictionary.Entry オブジェクトを作成する前に、ターゲットのエントリが含まれるデータ ディクショナリ セクションを表す Simulink.data.dictionary.Section オブジェクトを作成しなければなりません。ただし、作成後の Simulink.data.dictionary.Entry オブジェクトは、Simulink.data.dictionary.Section オブジェクトから独立した存在になります。Simulink.data.dictionary.Section オブジェクトの作成には関数 getSection を使用します。

作成

構文

説明

Simulink.data.dictionary.Entry オブジェクトは関数 addEntry、getEntry、find で作成されます。

プロパティ

すべて展開する

エントリを含むデータ ディクショナリのファイル名。文字ベクトルとして指定します。このプロパティに対する変更は、対応するデータ ディクショナリ エントリに反映されます。

例: 'myDictionary.sldd'

データ型: char

エントリの最終変更日時。協定世界時 (UTC) の形式の文字ベクトルとして返されます。このプロパティは読み取り専用です。

エントリを最後に変更したユーザーの名前。文字ベクトルとして返されます。このプロパティは読み取り専用です。

エントリの名前。文字ベクトルとして指定します。このプロパティに対する変更は、対応するデータ ディクショナリ エントリに反映されます。

データ型: char

エントリの状態。'New'、'Modified'、'Unchanged'、'Deleted' のいずれかの値として返されます。これはデータ ディクショナリが最後に保存されたときの状態を示します。状態が 'Deleted' の場合は、対応するエントリがデータ ディクショナリから削除されています。このプロパティは読み取り専用です。

オブジェクト関数

deleteEntryデータ ディクショナリ エントリを削除
discardChangesデータ ディクショナリ エントリに対する変更を破棄
find データ ディクショナリ エントリの配列を検索
getValueデータ ディクショナリ エントリの値を返す
setValueデータ ディクショナリ エントリの値を設定
showChangesデータ ディクショナリ エントリに対する変更を表示

例

すべて折りたたむ

データ ディクショナリ 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');

値が 27 の myEntry というエントリを myDictionary_ex_API.sldd の [Design Data] セクションに追加します。返される Simulink.data.dictionary.Entry オブジェクトを変数 e に代入します。

e = addEntry(dDataSectObj,'myEntry',27)
e = 

  Entry with properties:

              Name: 'myEntry'
             Value: 27
        DataSource: 'myDictionary_ex_API.sldd'
      LastModified: '2014-Aug-26 18:42:08.439709'
    LastModifiedBy: 'jsmith'
            Status: 'New'

myEntry の値を 27 から文字ベクトル 'My New Value' に変更します。

setValue(e,'My New Value')
e
e = 

  Entry with properties:

              Name: 'myEntry'
             Value: 'My New Value'
        DataSource: 'myDictionary_ex_API.sldd'
      LastModified: '2014-Aug-26 18:45:58.336598'
    LastModifiedBy: 'jsmith'
            Status: 'New'

データ ディクショナリ エントリ fuelFlow を fuelFlowObj という名前の Simulink.data.dictionary.Entry オブジェクトで表します。fuelFlow はデータ ディクショナリ myDictionary_ex_API.sldd で定義されています。

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

エントリ fuelFlow の値を返し、その値を変数 fuelFlowValue に代入します。

fuelFlowValue = getValue(fuelFlowObj)
fuelFlowValue =

   237

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

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

myDictionary_ex_API.sldd にあるエントリ fuelFlow を表す Simulink.data.dictionary.Entry オブジェクトを作成します。そのオブジェクトを変数 e に代入します。

e = getEntry(dDataSectObj,'fuelFlow')
e = 

  Entry with properties:

              Name: 'fuelFlow'
             Value: 237
        DataSource: 'myDictionary_ex_API.sldd'
      LastModified: '2014-Sep-05 13:12:06.099278'
    LastModifiedBy: 'jsmith'
            Status: 'Unchanged'

e の DataSource プロパティを変更して、エントリ fuelFlow を参照データ ディクショナリ myRefDictionary_ex_API.sldd に移動します。

e.DataSource = 'myRefDictionary_ex_API.sldd'
e = 

  Entry with properties:

              Name: 'fuelFlow'
             Value: 237
        DataSource: 'myRefDictionary_ex_API.sldd'
      LastModified: '2014-Sep-05 13:12:06.099278'
    LastModifiedBy: 'jsmith'
            Status: 'Modified'

myDictionary_ex_API.sldd は myRefDictionary_ex_API.sldd を参照しているため、両方のディクショナリが同じディクショナリ階層に属しており、それらの間でエントリ fuelFlow を移動することができます。

バージョン履歴

R2015a で導入

参考

| | | |

トピック