getSymbol

Get a symbol object definition of a C Function block

Since R2020a

Syntax

mySymbol = getSymbol(mySymbolSpec, name)

Description

mySymbol = getSymbol(mySymbolSpec, name) returns the Symbol object with the Name property specified by name associated with the SymbolSpec object.

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 associated with the C Function block, returned as a Symbol object.

Version History

Introduced in R2020a