Function
Renames a component in a Field.
Syntax
#include <dx/dx.h>
Object DXRename(Object o, char *oldname, char *newname)
Functional Details
Renames a component of the specified oldname to newname, for each Field in Object o. Object o can be a single Field or any Object that can contain Fields (for example, Groups or Series). If a newname already exists in a Field, it is replaced.
Return Value
It is an error if no components of the specified name are found in any of the Fields of o. Returns o on success, or returns NULL and sets the error code to indicate an error.
See Also
DXExists, DXExtract, DXInsert, DXRemove, DXReplace, DXGetComponentValue, DXSetComponentValue, DXSwap
12.10 , "Component Manipulation".