DsSetObjNameInteger(3D)

NAME
DsSetObjNameInteger - Set an object's name to an integer value

SYNOPSIS
C:
void DsSetObjNameInteger (object, name, replace)
DtObject object;
DtInt name;
DtFlag replace;
FORTRAN:
CALL DSSOND(OBJECT)
INTEGER*4 OBJECT
CALL DSSONI(OBJECT, OBJNUM, REPL)
INTEGER*4 OBJECT
INTEGER*4 OBJNUM
INTEGER*4 REPL

DESCRIPTION
DsSetObjNameInteger sets an object's name to the given integer value.

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 integer name of 0 is reserved to indicate a no-name condition. When DsSetObjNameInteger is called with an integer name of 0, the existing integer name is removed from the object.

FORTRAN SPECIFIC

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

DSSONI sets the name of OBJECT to the integer OBJNUM. This function gives an object an integer value name.

ERRORS
DsSetObjNameInteger will fail if the object is invalid.

[WARNING - invalid or deleted object]

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

[WARNING - object name already in use]

SEE ALSO
DsSetObjNameString(3D), DsInqObjViaInteger(3D), DsInqObjNameInteger(3D)