destroy

Delete data element and remove from data interface

Since R2023b

Syntax

destroy(archDataObj)

Description

destroy(archDataObj) deletes the architectural data object specified by archDataObj and removes it from the parent object.

Examples

Delete and Remove Data Interface from Architectural Data Section of Simulink Data Dictionary

This example shows how to delete a data interface and remove it from the Architectural Data section of a Simulink^® data dictionary.

Create a Simulink.dictionary.ArchitecturalData object by opening an existing data dictionary.

archDataObj = Simulink.dictionary.archdata.open("myInterfaceDict.sldd")

archDataObj = 

  ArchitecturalData with properties:

    DictionaryFileName: 'myInterfaceDict.sldd'
            Interfaces: [1×1 Simulink.dictionary.archdata.DataInterface]
             DataTypes: [0×0 Simulink.dictionary.archdata.DataType]
             Constants: [0×0 Simulink.dictionary.archdata.Constant]

The data dictionary has one data interface definition.

interfaceObj = archDataObj.Interfaces

interfaceObj = 

  DataInterface with properties:

           Name: 'DataInterface'
    Description: ''
       Elements: [0×0 Simulink.dictionary.archdata.DataElement]
          Owner: [1×1 Simulink.dictionary.ArchitecturalData]

Use the destroy function to delete the interface and remove it from the archDataObj.

destroy(interfaceObj)
archDataObj

archDataObj = 

  ArchitecturalData with properties:

    DictionaryFileName: 'myInterfaceDict.sldd'
            Interfaces: [0×0 Simulink.dictionary.archdata.DataInterface]
             DataTypes: [0×0 Simulink.dictionary.archdata.DataType]
             Constants: [0×0 Simulink.dictionary.archdata.Constant]

The data dictionary now has no interfaces.

Input Arguments

archDataObj — Architectural data object

Simulink.dictionary.ArchitecturalData object | Simulink.dictionary.archdata.DataInterface object | Simulink.dictionary.archdata.DataElement object | array of Simulink.dictionary.archdata.Constant objects | array of Simulink.dictionary.archdata.DataType objects | array of interface objects | Simulink.dictionary.archdata.AliasType object | Simulink.dictionary.archdata.ValueType | Simulink.dictionary.archdata.NumericType | Simulink.dictionary.archdata.PhysicalInterface | Simulink.dictionary.archdata.PhysicalElement | Simulink.dictionary.archdata.StructType | Simulink.dictionary.archdata.StructElement

Architectural Data object, specified as a Simulink.dictionary.ArchitecturalData object, or any object owned by Simulink.dictionary.ArchitecturalData.

Version History

Introduced in R2023b