Simulink.interface.dictionary.DataInterface

数据接口

自 R2022b 起

全页展开

    在 R2023b 中，引入了数据字典的“架构数据”部分。当管理接口、数据类型、常量和软件寻址方法时，请考虑改用 Simulink.dictionary.ArchitecturalData 编程接口。有关详细信息，请参阅Programmatically Manage AUTOSAR Architectural Data。

    说明

    数据接口表示通过连接器共享并通过端口进入或离开组件的信息。数据接口由描述所传输数据的结构的数据元素组成。数据接口可以是复合接口，并且可以引用其他数据接口。

    创建对象

    要创建一个 Simulink.interface.dictionary.DataInterface 对象，请使用 addDataInterface 函数将数据接口添加到现有 Simulink.interface.Dictionary 对象。

    dataInterfaceObj = addDataInterface(interfaceDictionaryObj,"interface1")

    属性

    全部展开

    数据接口的名称，指定为字符向量。

    数据类型: char | string

    数据接口的描述，指定为字符向量或字符串标量。

    数据类型: char | string

    属于数据接口对象的元素，指定为 Simulink.interface.dictionary.DataElement 对象数组。

    包含数据接口的接口字典，指定为 Simulink.interface.Dictionary 对象。

    对象函数

    addElement将数据元素添加到数据接口
    destroy销毁数据接口并从接口字典中删除
    getElement从数据接口获取数据元素
    removeElement从数据接口中删除数据元素
    show在接口编辑器中显示数据接口

    示例

    在数据接口中添加和删除数据元素

    此示例说明如何在数据接口中访问、添加和删除数据元素。

    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. 此接口字典包含一个数据接口定义。

      interfaceObj = interfaceDictObj.Interfaces
      interfaceObj = 
  DataInterface with properties:

           Name: 'interface1'
    Description: ''
       Elements: [1x2 Simulink.dictionary.archdata.DataElement]
          Owner: [1x1 Simulink.dictionary.ArchitecturalData]

    3. 数据接口由描述数据接口各部分的数据元素组成。此接口定义包含两个数据元素。 

      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')

    版本历史记录

    在 R2022b 中推出

    另请参阅

    | |