NAME

DsInqObjName − Return an object’s name from its object handle

SYNOPSIS

C:

void DsInqObjName(object, object_name_type,
object_name)
DtObject object;
DtNameType ∗object_name_type;
DtPtr object_name;

FORTRAN:

INTEGER∗4 DSQONT(OBJECT)
INTEGER∗4 OBJECT
INTEGER∗4 DSQONI(OBJECT)
INTEGER∗4 OBJECT
CALL DSQONS(OBJECT, FNAME, LENGTH)
INTEGER∗4 OBJECT
INTEGER∗4 LENGTH
CHARACTER∗LENGTH FNAME

DESCRIPTION

DsInqObjName returns an object’s name given its object handle.  The parameter object specifies the object.  The parameter object_name is  for the returned object name.  The parameter object_name_type returns the type of the object name that is passed back.  Possible return values for object_name_type are:

DcNameInteger <DCNINT>
An integer value name.

DcNameString <DCNSTR>
A string value name.  Object names are delimited by a trailing null.

DcNameNone <DCNNON>
No name given.

Doré maintains a system wide object name table subdivided by class.  The DsInqObjName function can obtain the name of any object in this table. 

FORTRAN SPECIFIC

DSQONT returns the class (object type) of the object OBJECT. 

DSQONI returns the name of the object OBJECT.  This function should be used when the object name is of type DCNINT (it’s an integer). 

DSQONS returns the name of the object OBJECT.  This function should be used when the object name is of type DCNSTR (it’s a string).  The string name is returned in FNAME and is LENGTH characters long. 

ERRORS

DsInqObjName will fail if the object handle is invalid. 

[WARNING - invalid or deleted object]

SEE ALSO

DsInqObj(3D)

September 02, 1992