addSymbol

Add a symbol object definition to a C Function block

Since R2020a

Syntax

mySymbol = addSymbol(mySymbolSpec)

mySymbol = addSymbol(mySymbolSpec, name)

Description

mySymbol = addSymbol(mySymbolSpec) creates a Symbol object, mySymbol, and adds the symbol to the SymbolSpec object, mySymbolSpec.

mySymbol = addSymbol(mySymbolSpec, name) creates a Symbol object, mySymbol, with the Name property specified by name and adds the symbol to the SymbolSpec object mySymbolSpec.

Examples

Specify and Edit Symbol Attributes Used in a C Function Block

Access and edit the properties of a symbol used in a C Function block.

Obtain the SymbolSpec object of the C Function block in your model using get_param. For example, select the C Function block in the model canvas and enter the following at the command line.

mySymbolSpec = get_param(gcb, 'SymbolSpec');

Use the addSymbol function to specify a new parameter symbol, myParam, in your C Function block code.

myParam = addSymbol(mySymbolSpec, 'myParam')

The Symbol object, myParam, uses default properties. Specify the scope of the symbol using the Scope property.

myParam.Scope = 'Parameter';

You can use the getSymbol function to access symbols specified for the block. For example, access the parameter symbol you added.

myParam = getSymbol(mySymbolSpec, 'myParam');

Edit the label of the parameter in the Block Parameters dialog using the Label property.

myParam.Label = 'Amplitude';

To delete a symbol from the SymbolSpec object, use the deleteSymbol function.

deleteSymbol(mySymbolSpec, 'myParam');

Input Arguments

mySymbolSpec — Symbol specifications of C Function block

SymbolSpec object

Symbol specifications of C Function block, specified as a SymbolSpec object.

name — Name of symbol

character vector

Name of the symbol, specified as a character vector.

Data Types: character

Output Arguments

mySymbol — Symbol

Symbol object

Symbol added to the C Function block, returned as a Symbol object. The Symbol object has default properties, except when you specify a name for the symbol in the input arguments. You can edit the properties of the Symbol object after creation.

Version History

Introduced in R2020a