Go to: Synopsis. Return value. Keywords. Related. Python examples.

Synopsis

renameAttr()

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

renameAttr is undoable, NOT queryable, and NOT editable.

Renames the given user-defined attribute to the name given in the string argument. If the new name conflicts with an existing name then this command will fail. Note that it is not legal to rename an attribute to the empty string.

Return value

string The new name. When undone returns the original name.

Keywords

node, connection, rename, attribute, dynamic

Related

addAttr, aliasAttr, attributeInfo, copyAttr, deleteAttr, getClassification, listAttr, nodeType, objExists, objectType, setAttr

Python examples

import maya.cmds as cmds

cmds.sphere( n='sph' )
cmds.addAttr( sn='ms', ln='mass', dv=1.0, min=0.001, max=10000 )
# Rename the long and short names separately
cmds.renameAttr( 'sph.mass', 'length' )
cmds.renameAttr( 'sph.ms', 'ln' )