discardChanges

データ ディクショナリに対する変更を破棄

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

構文

discardChanges(dictionaryObj)

説明

discardChanges(dictionaryObj) は、指定されたデータ ディクショナリが関数 saveChanges を使用して最後に保存された後にそのデータ ディクショナリに対して行われた変更をすべて破棄します。discardChanges は、参照データ ディクショナリに対する変更も破棄します。ターゲットのディクショナリおよびその参照ディクショナリに対する変更は完全に失われます。

例

例

すべて折りたたむ

データ ディクショナリ myDictionary_ex_API.sldd を表す Simulink.data.Dictionary オブジェクトを作成し、変数 myDictionaryObj に代入します。

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd')
myDictionaryObj = 

  Dictionary with properties:

          DataSources: {'myRefDictionary_ex_API.sldd'}
    HasUnsavedChanges: 0
           NumberOfEntries: 4

値が 237 の myNewEntry というエントリを追加することで myDictionary_ex_API.sldd に変更を加えます。myDictionaryObj の HasUnsavedChanges プロパティを表示して、変更が行われたことを確認します。

dDataSectObj = getSection(myDictionaryObj,'Design Data');
addEntry(dDataSectObj,'myNewEntry',237);
myDictionaryObj
myDictionaryObj = 

  Dictionary with properties:

          DataSources: {'myRefDictionary_ex_API.sldd'}
    HasUnsavedChanges: 1
           NumberOfEntries: 5

myDictionary_ex_API.sldd に対する変更をすべて破棄します。myDictionaryObj の HasUnsavedChanges プロパティで、変更が破棄されたことを確認します。

discardChanges(myDictionaryObj)
myDictionaryObj
myDictionaryObj = 

  Dictionary with properties:

          DataSources: {'myRefDictionary_ex_API.sldd'}
    HasUnsavedChanges: 0
           NumberOfEntries: 4

入力引数

すべて折りたたむ

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

代替方法

  • Simulink.data.DataConnection オブジェクト関数を使用して、データ ディクショナリへの変更を破棄します。

    データ ディクショナリ内の変数 x の値を取得します。

    dd = Simulink.data.connect("myDictionary.sldd");
dd.x 

    ans = 
    1

    変数 x を更新し、その新しい値を取得します。

    dd.x = dd.x + 2;
dd.x 

    ans = 
    3

    データ ディクショナリへの変更を破棄します。変数 x は元の値に戻ります。

    success = discardChanges(dd);
dd.x

    ans = 
    1

  • モデル エクスプローラーのウィンドウを使用して、データ ディクショナリに対する変更を破棄することができます。詳細については、ディクショナリのエントリの変更表示と変更取り消しを参照してください。

バージョン履歴

R2015a で導入

参考

| | |

トピック