Use these functions to return data about the MATLAB® Runtime state when working with shared libraries.
| Function and Signature | When to Use | Return Value |
|---|---|---|
bool mclIsMCRInitialized() | Use mclIsMCRInitialized() to determine whether or
not the MATLAB Runtime has been properly initialized. | Boolean (true or false).
Returns true if MATLAB Runtime is already initialized, else returns
false. |
bool mclIsJVMEnabled() | Use mclIsJVMEnabled() to determine if the
MATLAB Runtime is started with an instance of a Java® Virtual Machine (JVM™). | Boolean (true or false).
Returns true if MATLAB Runtime has been started with a JVM instance, else returns false. |
const char* mclGetLogFileName() | Use mclGetLogFileName() to retrieve the name of
the log file used by the MATLAB Runtime. | Character string representing log file name used by the MATLAB Runtime, preceded by the character. |
bool mclIsNoDisplaySet() | Use mclIsNoDisplaySet() to determine if
-nodisplay option is enabled. | Boolean (true or false).
Returns true if -nodisplay is
enabled, else returns false. Note
When running on Mac, if |
Note
All of these attributes have properties of write-once, read-only.
The following example demonstrates how to pass options to a C or C++ shared library and how to retrieve the corresponding values after they are set.
const char* options[4];
options[0] = "-logfile";
options[1] = "logfile.txt";
options[2] = "-nojvm";
options[3] = "-nodisplay";
if( !mclInitializeApplication(options,4) )
{
fprintf(stderr,
"Could not initialize the application.\n");
return -1;
}
printf("MCR initialized : %d\n", mclIsMCRInitialized());
printf("JVM initialized : %d\n", mclIsJVMEnabled());
printf("Logfile name : %s\n", mclGetLogFileName());
printf("nodisplay set : %d\n", mclIsNoDisplaySet());
fflush(stdout);