DsSetObjNameString(3D)

NAME
DsSetObjNameString - Set an object's name to a string value

SYNOPSIS
C:
void DsSetObjNameString (object, name, replace)
DtObject object;
char *name;
DtFlag replace;

FORTRAN:
CALL DSSOND(OBJECT)
INTEGER*4 OBJECT

CALL DSSONS(OBJECT, OBJSTR, N, REPL)
INTEGER*4 OBJECT
INTEGER*4 REPL
INTEGER*4 N
CHARACTER*N OBJSTR

DESCRIPTION
DsSetObjNameString sets an object's name to the specified character string. A copy of the given string is created for the dictionary.

The parameter object specifies the object to receive the new name.

If the replace flag is false, then this function will report an error if another object of the same type already has this name. If replace is true, then the name will be set for the object and removed from all other objects that have the same name.

Note that the passing a null pointer as the object's name specifies that the existing name is to be removed from the object.

FORTRAN SPECIFIC
DSSOND sets the name of OBJECT to DCNNON. No name is given; the object name will be ignored.

DSSONS sets the name of OBJECT to the string of N characters in OBJSTR. This function gives an object a string value name.

ERRORS
DsSetObjNameString will fail if the object is invalid.

[WARNING - invalid or deleted object]

DsSetObjNameString will fail if the replace parameter is true and another object has the same name.

[WARNING - object name already in use]

SEE ALSO
DsSetObjNameInteger(3D), DsInqObjViaString(3D), DsInqObjNameString(3D)