mclInitializeApplication - Set up application state shared by all (future) MCR instances created in current process

Synopsis

bool 
  mclInitializeApplication(const char **options, int count)

Description

MATLAB Compiler-generated standalone executables contain auto-generated code to call this function; users of shared libraries must call this function manually. Call only once per process. The function takes an array of strings (possibly of zero length) and a count containing the size of the string array. The string array may contain the following MATLAB command line switches, which have the same meaning as they do when used in MATLAB. :

• -appendlogfile

• -Automation

• -beginfile

• -debug

• -defer

• -display

• -Embedding

• -endfile

• -fork

• -java

• -jdb

• -logfile

• -minimize

• -MLAutomation

• -noaccel

• -nodisplay

• -noFigureWindows

• -nojit

• -nojvm

• -noshelldde

• -nosplash

• -r

• -Regserver

• -shelldde

• -student

• -Unregserver

• -useJavaFigures

• -mwvisual

• -xrm

Caution   mclInitializeApplication must be called once only per process. Calling mclInitializeApplication more than once may cause your application to exhibit unpredictable or undesirable behavior.

Caution   When running on Mac, if -nodisplay is used as one of the options included in mclInitializeApplication, then the call to mclInitializeApplication must occur before calling mclRunMain.

Examples

To start all MCRs in a given process with the -nodisplay option, for example, use the following code:

const char *args[] = { "-nodisplay" }; 
if (! mclInitializeApplication(args, 1))
{
   fprintf(stderr, 
           "An error occurred while initializing: \n %s ",
           mclGetLastErrorMessage());
   return -1;  
}

See Also

mclTerminateApplication

How To

• Initializing and Terminating Your Application with mclInitializeApplication and mclTerminateApplication

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS