DsInqObjNameString(3D)

NAME
DsInqObjNameString - Return the name of a string-named object

SYNOPSIS
C:
char* DsInqObjNameString (object)
DtObject object;
FORTRAN:
CALL DSQONS(OBJECT, FNAME, LENGTH)
INTEGER*4 OBJECT
INTEGER*4 LENGTH
CHARACTER*LENGTH FNAME

DESCRIPTION
DsInqObjNameString returns the string name of the object. If the object has no string-valued name, the function will return null, otherwise it returns a pointer to the character string specified via the DsSetObjNameString function.

The parameter object specifies the object that is queried.

FORTRAN SPECIFIC

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
DsInqObjNameString will fail if the object is invalid.

[WARNING - invalid or deleted object]

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