DsSetObjName(3D) — Kubota Pacfic Computer Inc. (\*(Dd)

NAME

DsSetObjName − Set the name of an object

SYNOPSIS

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]

Museum