Function me::Rename(runtimeId, newname)

me::Rename

The procedure me::Rename renames a runtime identifier. In addition, all text within the runtime library referencing that runtime identifier will be adapted accordingly.

me::Rename(
        runtimeId,  ! (input) an element
        newname     ! (input) a string
)

Arguments

runtimeId

An element in the set AllIdentifiers referencing a runtime identifier.

newname

A string.

Return Value

Returns 1 if the rename operation is successful, 0 otherwise. In the latter case error(s) have been raised. When runtimeId doesn’t reference a runtime identifier an error will be raised.

Note

The name change file is not supported for runtime libraries.

Example

Viewing a small runtime library with prefix frerl in the model explorer:

../../_images/runtimelib-setup.png

Let

  • ep_functionReferenceExampleRuntimeParameter refer to the parameter in the runtime library then the code:

me::Rename(
        runtimeId :  ep_functionReferenceExampleRuntimeParameter,
        newName   :  "p_b");

renames the parameter as shown below:

../../_images/runtimelib-after-rename.png

References

Generic references for model edit functions can be found on the index page