Main Content

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

Simulink.interface.dictionary.DataInterface

データ インターフェイス

R2022b 以降

    説明

    データ インターフェイスは、コネクタを通じて共有され、端子を通じてコンポーネントに出入りする情報を表します。データ インターフェイスは、送信データの構造を記述するデータ要素で構成されます。データ インターフェイスは複合にすることができ、他のデータ インターフェイスを参照できます。

    作成

    Simulink.interface.dictionary.DataInterface オブジェクトを作成するには、関数 addDataInterface を使用して既存の Simulink.interface.Dictionary オブジェクトにデータ インターフェイスを追加します。

    dataInterfaceObj = addDataInterface(interfaceDictionaryObj,"interface1")

    プロパティ

    すべて展開する

    データ インターフェイスの名前。文字ベクトルとして指定します。

    データ型: char | string

    データ インターフェイスの説明。文字ベクトルまたは string スカラーとして指定します。

    データ型: char | string

    データ インターフェイス オブジェクトに属する要素。Simulink.interface.dictionary.DataElement オブジェクトの配列として指定します。

    データ インターフェイスを含むインターフェイス ディクショナリ。Simulink.interface.Dictionary オブジェクトとして指定します。

    オブジェクト関数

    addElementデータ インターフェイスへのデータ要素の追加
    destroyデータ インターフェイスの破棄とインターフェイス ディクショナリからの削除
    getElementデータ インターフェイスからのデータ要素の取得
    removeElementデータ インターフェイスからのデータ要素の削除
    showインターフェイス エディターでのデータ インターフェイスの表示

    すべて折りたたむ

    この例では、データ インターフェイスのデータ要素にアクセスする方法と追加および削除する方法を示します。

    既存のインターフェイス ディクショナリを開きます。これにより、Simulink.interface.Dictionary オブジェクト interfaceDictObj が作成されます。

    interfaceDictObj = Simulink.interface.dictionary.open('myInterfaceDict.sldd')
    interfaceDictObj = 
      ArchitecturalData with properties:
    
        DictionaryFileName: 'myInterfaceDict.sldd'
                Interfaces: [1x1 Simulink.dictionary.archdata.DataInterface]
                 DataTypes: [0x0 Simulink.dictionary.archdata.DataType]
                 Constants: [0x0 Simulink.dictionary.archdata.Constant]
    
    

    このインターフェイス ディクショナリには、データ インターフェイス定義が 1 つ含まれています。

    interfaceObj = interfaceDictObj.Interfaces
    interfaceObj = 
      DataInterface with properties:
    
               Name: 'interface1'
        Description: ''
           Elements: [1x2 Simulink.dictionary.archdata.DataElement]
              Owner: [1x1 Simulink.dictionary.ArchitecturalData]
    
    

    データ インターフェイスは、データ インターフェイスの各部分を記述するデータ要素で構成されます。このインターフェイス定義に含まれるデータ要素は 2 つです。

    interfaceObj.Elements(1)
    ans = 
      DataElement with properties:
    
               Name: 'element1'
               Type: [1x1 Simulink.dictionary.archdata.ValueType]
        Description: ''
         Dimensions: '1'
              Owner: [1x1 Simulink.dictionary.archdata.DataInterface]
    
    
    interfaceObj.Elements(2)
    ans = 
      DataElement with properties:
    
               Name: 'element2'
               Type: [1x1 Simulink.dictionary.archdata.ValueType]
        Description: ''
         Dimensions: '1'
              Owner: [1x1 Simulink.dictionary.archdata.DataInterface]
    
    

    関数 addElement を使用してデータ インターフェイスに新しいデータ要素を追加します。

    dataElem1 = addElement(interfaceObj, 'element3')
    dataElem1 = 
      DataElement with properties:
    
               Name: 'element3'
               Type: [1x1 Simulink.dictionary.archdata.ValueType]
        Description: ''
         Dimensions: '1'
              Owner: [1x1 Simulink.dictionary.archdata.DataInterface]
    
    

    既存のデータ要素には関数 getElement を使用してアクセスできます。

    dataElem3 = getElement(interfaceObj, 'element3')
    dataElem3 = 
      DataElement with properties:
    
               Name: 'element3'
               Type: [1x1 Simulink.dictionary.archdata.ValueType]
        Description: ''
         Dimensions: '1'
              Owner: [1x1 Simulink.dictionary.archdata.DataInterface]
    
    

    関数 removeElement を使用してインターフェイスからデータ要素を削除します。

    removeElement(interfaceObj, 'element3')

    バージョン履歴

    R2022b で導入