addElement

Add function element to service interface

Since R2023b

Syntax

functionElementObj = addElement(serviceInterfaceObj,elementName)

Description

functionElementObj = addElement(serviceInterfaceObj,elementName) creates a Simulink.dictionary.archdata.FunctionElement object with the name elementName and adds the element to the service interface object serviceInterfaceObj.

Examples

Configure Function Elements of a Service Interface

To configure function elements of a service interface, use the addElement, getElement, and removeElement functions.

In this example, the dictionary MyInterfaces.sldd contains one service interface.

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

archDataObj = 

  ArchitecturalData with properties:

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

Get the service interface object using the getInterface function. The service interface object contains two function element objects.

serviceInterfaceObj = getInterface(archDataObj,"ServiceInterface1")

serviceInterfaceObj = 

  ServiceInterface with properties:

           Name: 'ServiceInterface1'
    Description: ''
       Elements: [1×2 Simulink.dictionary.archdata.FunctionElement]
          Owner: [1×1 Simulink.dictionary.ArchitecturalData]

To create a function element object and add it to the service interface, use the addElement function.

funcElemObj3 = addElement(serviceInterfaceObj,"functionElement3")

funcElemObj3 = 

  FunctionElement with properties:

    FunctionPrototype: 'y = functionElement3(u)'
         Asynchronous: 0
    FunctionArguments: [1×2 Simulink.dictionary.archdata.FunctionArgument]
                 Name: 'functionElement3'
                Owner: [1×1 Simulink.dictionary.archdata.ServiceInterface]

To access an existing function element, use the getElement function.

funcElemObj2 = getElement(serviceInterfaceObj,"functionElement2")

funcElemObj2 = 

  FunctionElement with properties:

    FunctionPrototype: 'y = functionElement2(u)'
         Asynchronous: 0
    FunctionArguments: [1×2 Simulink.dictionary.archdata.FunctionArgument]
                 Name: 'functionElement2'
                Owner: [1×1 Simulink.dictionary.archdata.ServiceInterface]

To remove a function element from a service interface, use the removeElement function.

removeElement(serviceInterfaceObj,"functionElement1")

The service interface object now contains only two function elements, functionElement2 and functionElement3.

serviceInterfaceObj.Elements(1)

ans = 

  FunctionElement with properties:

    FunctionPrototype: 'y = functionElement2(u)'
         Asynchronous: 0
    FunctionArguments: [1×2 Simulink.dictionary.archdata.FunctionArgument]
                 Name: 'functionElement2'
                Owner: [1×1 Simulink.dictionary.archdata.ServiceInterface]

serviceInterfaceObj.Elements(2)

ans = 

  FunctionElement with properties:

    FunctionPrototype: 'y = functionElement3(u)'
         Asynchronous: 0
    FunctionArguments: [1×2 Simulink.dictionary.archdata.FunctionArgument]
                 Name: 'functionElement3'
                Owner: [1×1 Simulink.dictionary.archdata.ServiceInterface]

Input Arguments

serviceInterfaceObj — Service interface object

Simulink.dictionary.archdata.ServiceInterface object

Service interface object, specified as a Simulink.dictionary.archdata.ServiceInterface object.

elementName — Function element name

character vector | string scalar

Function element name, specified as a character vector or string scalar.

Data Types: char | string

Output Arguments

functionElementObj — Function element

Simulink.dictionary.archdata.FunctionElement object

Function element, returned as a Simulink.dictionary.archdata.FunctionElement object.

Version History

Introduced in R2023b