qualifiedTypeName()

The javaLib.qualifiedTypeName() system function returns the fully qualified name of the class of an object in the EGL Java™ object space.

For more about the EGL Java object space in which javaLib.qualifiedTypeName() and similar functions operate, see Java access functions. EGL maintains this method of Java access for compatibility with earlier versions. For new code, use the more powerful ExternalType syntax; for more information, see ExternalType part.

Syntax

  javaLib.qualifiedTypeName(identifier javaObjId in)
  returns (result STRING)
identifier
A case-sensitive identifier that refers to an object in the object space. Input can be any variable or expression that is assignment compatible with the STRING type, and is cast to the Java objID type, as in a later example. EGL strips single- and double-byte blanks from the beginning and end of the argument value.
result
If you assign the return value to a variable, that variable must be assignment compatible with the STRING type.

Example

The following example returns the class name associated with the specified ID:

  myClassName = javaLib.qualifiedTypeName("myId" as "objID:java");

Error considerations

If the v60ExceptionCompatibility program property is not set, or is set to NO, an exception causes EGL to throw a JavaObjectException. Other errors cause EGL to throw a RuntimeException.

If the v60ExceptionCompatibility program property is set to YES, an error during processing of javaLib.qualifiedTypeName() can set sysVar.errorCode to a value listed in the next table.

Table 1. qualifiedTypeName() error codes
Value in sysVar.errorCode Description
00001001 The object had a null value, or the specified identifier was not in the object space

Feedback