getReferences

Identify references to symbol name

Since R2023a

collapse all in page

Syntax

references = getReferences(symbol)

Description

references = getReferences(symbol) returns an array of Stateflow.SymbolReference objects that indicate where the chart refers to a symbol name. For example, a Stateflow.SymbolReference object can correspond to a state or transition action that includes the symbol name. Symbols include Stateflow.Data, Stateflow.Event, Stateflow.Message, and other Stateflow® objects that have a Name property.

example

Examples

collapse all

This example uses:

Open Live Script

Rename and update the references to the chart output y.

A chart with two states named On and Off. The On state contains the action 'y = x'. The Off state contains the action 'y = 0'.

Open the model and access the Stateflow.Data object for the chart output y.

open_system("sfRectifyAPIExample")
data = find(sfroot,"-isa","Stateflow.Data",Scope="Output");
data.Name
ans = 
'y'

Find the locations where the chart refers to the chart output.

references = getReferences(data)
references=2×1 SymbolReference array with properties:
    Position
    WhereUsed

Display the names and entry actions of the states that refer to the chart output.

whereUsed = [references.WhereUsed];
classes = arrayfun(@class,whereUsed,UniformOutput=false);
idx = (classes=="Stateflow.State");
states = whereUsed(idx);
get(states,{"Name" "EntryAction"})
ans = 2×2 cell
    {'On' }    {'y = x;'}
    {'Off'}    {'y = 0;'}

Change the Name property of the chart output to "z" and update the references to the output in the chart. 

renameReferences(data,"z")
data.Name
ans = 
'z'

Display the names and modified entry actions of the states that refer to the chart output.

get(states,{"Name" "EntryAction"})
ans = 2×2 cell
    {'On' }    {'z = x;'}
    {'Off'}    {'z = 0;'}

Input Arguments

collapse all

Limitations

  • The functions getReferences and renameReferences do not find or update references to exported functions in other charts, atomic subcharts, or Function Caller (Simulink) blocks.

Version History

Introduced in R2023a

See Also

Functions

Objects

Topics