Main Content

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

addElement

データ インターフェイスへのデータ要素の追加

R2022b 以降

    説明

    dataElementObj = addElement(dataInterfaceObj,elementName) は、指定された名前の Simulink.interface.dictionary.DataElement オブジェクトを作成し、それを Simulink.interface.dictionary.DataInterface オブジェクト dataInterfaceObj に追加します。

    データ インターフェイスのデータ要素の追加と削除

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

    1. 既存のインターフェイス ディクショナリを開きます。これにより、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]
      
      
    2. このインターフェイス ディクショナリには、データ インターフェイス定義が 1 つ含まれています。

      interfaceObj = interfaceDictObj.Interfaces
      interfaceObj = 
        DataInterface with properties:
      
                 Name: 'interface1'
          Description: ''
             Elements: [1x2 Simulink.dictionary.archdata.DataElement]
                Owner: [1x1 Simulink.dictionary.ArchitecturalData]
      
      
    3. データ インターフェイスは、データ インターフェイスの各部分を記述するデータ要素で構成されます。このインターフェイス定義に含まれるデータ要素は 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]
      
      
    4. 関数 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]
      
      
    5. 既存のデータ要素には関数 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]
      
      
    6. 関数 removeElement を使用してインターフェイスからデータ要素を削除します。

      removeElement(interfaceObj, 'element3')

    入力引数

    すべて折りたたむ

    要素を追加するデータ インターフェイス。Simulink.interface.dictionary.DataInterface オブジェクトとして指定します。

    dataInterfaceObj オブジェクトに追加するデータ要素の名前。文字ベクトルまたは string スカラーとして指定します。

    出力引数

    すべて折りたたむ

    データ要素。指定した名前と既定のプロパティ値をもつ Simulink.interface.dictionary.DataElement オブジェクトとして返されます。

    バージョン履歴

    R2022b で導入

    すべて展開する