Engine.Engine
Engine class constructor
Calling Sequence
Parameters
Description
Examples
Engine( String args[], EngineCallBacks cb, Object user_data, Object res )
args
-
start up command-line arguments
cb
call back methods
user_data
arbitrary data to be passed into the call backs
res
reserved for future use
Engine is the constructor for the Engine class. Creating an instance of Engine starts the Maple session. Only one instance of Engine should be created during the execution of the Java program.
The args parameter is an array of Strings to be passed as command-line arguments to Maple. The String at index 0 should be set to "java".
The cb parameter is a instance of a class implementing the EngineCallBacks interface. It specifies the callbacks used by the kernel.
The user_data parameter is a data element that is passed into each callback specified in cb.
The res parameter is a data element that is reserved for future use. Programs calling Engine must always pass Java null for res.
(Windows only) If there are errors running a Java OpenMaple program with an atypical Java Virtual Machine, try passing the full path to the Java Virtual Machine executable as the zero'th string in args.
import com.maplesoft.openmaple.*;
import com.maplesoft.externalcall.MapleException;
class Example
{
public static void main( String notused[] ) throws MapleException
String[] mapleArgs = { "java" };
Engine engine = new Engine( mapleArgs, new EngineCallBacksDefault(), null, null );
engine.evaluate( "int(x,x);" );
engine.evaluate( "LinearAlgebra:-RandomMatrix( 3, 3 );" );
try
engine.evaluate( "syntax_error" );
}
catch ( MapleException me )
System.out.println( "Error: "+me.getMessage() );
Executing this code produces the following output.
1/2*x^2
Matrix(3,3,{(1, 1) = -21, (1, 2) = -50, (1, 3) = -79, (2, 1) = -56, (2, 2) = 30, (2, 3) = -71, (3, 1) = -8, (3, 2) = 62, (3, 3) = 28},datatype = anything,storage = rectangular,order = Fortran_order,shape = [])
Error: at offset 13, unexpected end of statement
See Also
maple
OpenMaple
OpenMaple/Java/API
OpenMaple/Java/Engine
Download Help Document
