<library>Initialize[WithHandlers] - Initialize MCR instance associated with library

Synopsis

bool libraryInitialize(void) 
bool libraryInitializeWithHandlers( 
             mclOutputHandlerFcn error_handler, 
             mclOutputHandlerFcn print_handler) 

Description

Each generated library has its own MCR instance. These two functions, libraryInitialize and libraryInitializeWithHandlers initialize the MCR instance associated with library. Users must call one of these functions after calling mclInitializeApplication and before calling any of the compiled functions exported by the library. Each returns a boolean indicating whether or not initialization was successful. If they return false, calling any further compiled functions will result in unpredictable behavior. libraryInitializeWithHandlers allows users to specify how to handle error messages and printed text. The functions passed to libraryInitializeWithHandlers will be installed in the MCR instance and called whenever error text or regular text is to be output.

Examples

if (!libmatrixInitialize())
{
    fprintf(stderr, 
            "An error occurred while initializing: \n %s ",
            mclGetLastErrorMessage());
    return -2;
} 

See Also

<library>Terminate

How To

• Library Initialization and Termination Functions

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