renameReferences

シンボル名の変更とそのシンボル名への参照の更新

R2023a 以降

ページ内をすべて折りたたむ

構文

renameReferences(symbol,newName)

説明

renameReferences(symbol,newName) は、symbol の名前を newName に変更し、チャート内のそのシンボル名への参照を更新します。シンボルには、Stateflow.Data、Stateflow.Event、Stateflow.Message、および Name プロパティをもつその他の Stateflow® オブジェクトが含まれます。

例

例

すべて折りたたむ

この例では次を使用します。

ライブ スクリプトを開く

チャート出力 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'.

モデルを開き、チャート出力 y の Stateflow.Data オブジェクトにアクセスします。

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

チャートがチャート出力を参照している場所を特定します。

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

チャート出力を参照するステートの名前と entry アクションを表示します。

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;'}

チャート出力の Name プロパティを "z" に変更し、チャート内のその出力への参照を更新します。 

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

チャート出力を参照するステートの名前と変更された entry アクションを表示します。

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

入力引数

すべて折りたたむ

シンボルの新しい名前。string スカラーまたは文字ベクトルとして指定します。

制限

  • 関数 getReferences と関数 renameReferences は、他のチャート、Atomic サブチャート、または Function Caller (Simulink) ブロック内にあるエクスポートされた関数への参照の特定や更新は行いません。

バージョン履歴

R2023a で導入

参考

関数

オブジェクト

トピック