DsSetObjName(3D)

NAME
DsSetObjName - This function is obsolete and has been replaced by DsSetObjNameInteger and DsSetObjNameString

SYNOPSIS
C:
void DsSetObjName(object, name_type, object_name,
	replace)
DtObject object;
DtNameType name_type;
DtPtr object_name;
DtFlag replace;

FORTRAN:
CALL DSSOND(OBJECT)
INTEGER*4 OBJECT

CALL DSSONI(OBJECT, OBJNUM, REPL)
INTEGER*4 OBJECT
INTEGER*4 OBJNUM
INTEGER*4 REPL

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

DESCRIPTION
DsSetObjName sets the name of an object, object, to object_name. The parameter name_type specifies the type of object_name. Possible values for name_type are:

DcNameInteger
    object_name is an integer value name.

DcNameString
    object_name is a string value name.

DcNameNone
    No name given; the object name will be ignored. The user may pass an object_name of DcNullPtr here.

No two objects of the same object type may have the same object name. The replace flag signals whether to report an error if an object of the same type already has this name (DcOff <DCOFF>) or to set the name in all cases and remove the name from any object (of this type) that has the proposed name (DcOn <DCON>).

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.

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

ERRORS
DsSetObjName will fail if the object is invalid.

[WARNING - invalid or deleted object]

DsSetObjName will fail if the name is already in use and the replace flag is not DcOn <DCON>.

[WARNING - object name already in use]

SEE ALSO
DsInqObj(3D), DsInqObjName(3D)