DsInqObjViaInteger(3D)

NAME
DsInqObjViaInteger - Return an integer-named object's handle

SYNOPSIS
C:
DtObject DsInqObjViaInteger (name, class_id)
DtInt name;
DtInt class_id;
FORTRAN:
INTEGER*4 DSQOI(OBJNUM, CLASID)
INTEGER*4 OBJNUM
INTEGER*4 CLASID

DESCRIPTION
DsInqObjViaInteger returns a handle to the object named with the given integer value. Objects are named with integers via the DsSetObjNameInteger function (they are not named automatically when created).

The parameter class_id contains an integer indicating the class (or type) of the object being queried. The integer representing a particular class can be determined using DsInqClassId(class_name) where class_name is the C name of the DoXXX function used to create an object. For example, DsInqClassId("DoScale") returns the integer class identification value for a scale object.

Note that object can also be assigned character string names; see DsSetObjNameString(3D).

FORTRAN SPECIFIC

Function DSQOI queries the handle of an object when the name is of type DCNINT. OBJNUM is the integer name of the object and CLASID is an integer value indicating the class (or type) of the object being queried. The integer representing a particular class can be determined using DSQCI(CLSNME,N) where CLSNME is the C name of the DoXXXXX function used to create an object and N is the length of the C name. For example, DSQCI('DoScale', 7) returns the integer class value for a scale object.

ERRORS
DsInqObjViaInteger will fail if no such named object exists.

[WARNING - invalid or deleted object]

SEE ALSO
DsInqObjNameType(3D), DsInqObjViaString(3D),
DsSetObjNameInteger(3D), DsSetObjNameString(3D)