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

NAME

DsInqObj − Return an object specified by name

SYNOPSIS

DtObject DsInqObj(object_name_type, object_name, object_type)
DtNameType object_name_type;
DtPtr object_name;
DtInt object_type;

Fortran:

INTEGER∗4 DSQOI(OBJNUM, OBJTYP)
INTEGER∗4 OBJNUM
INTEGER∗4 OBJTYP
INTEGER∗4 DSQOS(OBJSTR, N, OBJTYP)
INTEGER∗4 N
CHARACTER∗N OBJSTR
INTEGER∗4 OBJTYP

DESCRIPTION

DsInqObj returns a handle to an object. The parameter object_name specifies the name of the object. The parameter object_type contains an integer indicating the type of the object being queried. The integer representing a particular object type can be determined using DsInqClassId(class_name) where class_name is the C name of the DoXXXXX function used to create an object. For example, DsInqClassId("DoScale") returns the integer object type value for a scale object. Possible values for object_name_type are:

DcNameInteger
An integer value name.

DcNameString
A string value name.

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 OBJTYP is an integer value indicating the type of object being queried. The integer representing a particular object type 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 object type value for a scale object.

Function DSQOI 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. OBJTYP is an integer value indicating the type of object.

ERRORS

DsInqObj will fail if the name_type argument is invalid.

[WARNING - invalid parameter]

Museum