DMRenameData Procedure
Renames a dataset stored in the current PV‑WAVE session.
Usage
DMRenameData, data_name, new_var_name
Input Parameters
data_name—A scalar string containing a data name (in the default domain, $GLOBAL
) or a 2-element string array containing a domain name and data name of the data you wish to rename.
new_var_name—A string containing a new variable name.
Discussion
This function cannot be used to move data to a new domain. Only the name of the data can be changed.
The original data_name data no longer exists after this function is called.
Storage for the domain and data are automatically created if they do not already exist. If data with the new_var_name already exists, it is overwritten. The data name and domain name are used to uniquely identify a dataset stored on the JWAVE server. Normally, these names are set in the JWAVE client application.
To be valid, the data_name input parameter name must begin with a letter. The name is not case-sensitive, and may contain letters, underscores, and numbers.
Examples
This command renames (moves) the data named STUFF
from the default domain ($GLOBAL
) and gives it a new name of NEW_STUFF
(in the same domain).
DMRenameData, ['
$GLOBAL'
,'
STUFF'
],'
NEW_STUFF'
See Also
DMCopyData, DMDataExists, DMEnumerateData, DMGetData, MInit, DMRemoveData, DMStoreData