DsInqObjViaString(3D)

NAME
DsInqObjViaString - Return a string-named object's handle

SYNOPSIS
C:
DtObject DsInqObjViaString (name, class_id)
char* name;
DtInt class_id;
FORTRAN:
INTEGER*4 DSQOS(OBJSTR, N, CLASID)
INTEGER*4 N
CHARACTER*N OBJSTR
INTEGER*4 CLASID

DESCRIPTION
DsInqObjViaString returns a handle to the object named with the specified name string. Objects are assigned string names via the DsSetObjNameString 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 integer identifiers; see DsSetObjNameInteger(3D).

FORTRAN SPECIFIC

Function DSQOS queries the handle of an object when the object name is of the type DCNSTR. OBJSTR is a string of N characters containing the name of the object. CLASID is an integer value indicating the class (or type) of the object being queried.

ERRORS
DsInqObjViaString will fail if no such named object exists.

[WARNING - invalid or deleted object]

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