storeNew()

  javaLib.storeNew(
    storeId javaObjId in,
    class STRING in
    {, argument anyEglPrimitive in})

storeId

A case-sensitive name that identifies the new object. Input can be any variable or expression that is assignment compatible with the STRING type, and is cast to objID, as in a later example. EGL strips single- and double-byte blanks from the beginning and end of the argument value.

class

The fully qualified, case-sensitive name of a Java™ class. Input can be any variable or expression that is assignment compatible with the STRING type. EGL strips single- and double-byte blanks from the beginning and end of the argument value.

argument

A value passed to the constructor. A cast might be required; see "Mapping EGL primitives to Java™." The Java™ type-conversion rules are in effect. No error occurs, for example, if you pass a SMALLINT to a constructor parameter that is declared as an int. To avoid losing precision, use an EGL FLOAT for a Java™ double, and an EGL SMALLFLOAT for a Java™ float. Using one of the other EGL types can result in a rounding error.

A value of an EGL external type is valid, as shown here:

SharedResourcePowerServer srps = JavaLib.getSharedResourcePowerServer();
JavaLib.storeNew("storeId" as "objID:java", "myClass", srps);

In the following example, the function places a newly created object in the object space.

  javaLib.storeNew("storeId" as "objID:java", "myClass", 36 );

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

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