DsInqObjName(3D) — Stardent Computer Inc. (\*(Dd)

NAME

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

SYNOPSIS

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 holds a pointer to the object name. The parameter object_name_type holds the type of the object name. Possible return values for object_name_type are:

DcNameInteger
An integer value name.

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

DcNameNone
No name given.

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

FORTRAN SPECIFIC

DSQONT returns the object type (class) 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]

Museum