C++ `mwArray` API Shared Library Integration

Create and integrate packaged MATLAB^® functions into C++ applications using the mwArray API

The C++ mwArray API supports only C++03 functionality. C++ shared libraries that use the mwArray API have an interface that uses C-style functions to initialize the MATLAB Runtime, load the packaged MATLAB functions into the MATLAB Runtime, and manage data that is passed between the C++ driver code and MATLAB Runtime. These functions are described under C/C++ API. The functions listed under C++ mwArray API are specific to the mwArray API and cannot be used for shared libraries created for other APIs.

Functions

`compiler.build.cppSharedLibrary`	Create C++ shared library
`compiler.build.CppSharedLibraryOptions`	Options for building C++ shared libraries
`mbuild`	Compile and link source files against MATLAB generated shared libraries

C/C++ API

`mclmcrInitialize`	Initialize the MATLAB Runtime proxy library
`mclInitializeApplication`	Set up application state shared by all MATLAB Runtime instances created in current process
`mclTerminateApplication`	Close MATLAB Runtime-internal application state
`<library>Initialize[WithHandlers]`	Initialize MATLAB Runtime instance associated with `library`
`<library>Terminate`	Free all resources allocated by MATLAB Runtime instance associated with `library`
`mclRunMain`	Mechanism for creating identical wrapper code across all platforms
`mclIsMCRInitialized`	Determine if MATLAB Runtime has been properly initialized
`mclWaitForFiguresToDie`	Enable deployed applications to process graphics events so that figure windows remain displayed
`mclGetLastErrorMessage`	Last error message from unsuccessful library initialization or MATLAB function call
`mclGetLogFileName`	Retrieve name of log file used by MATLAB Runtime
`mclIsJVMEnabled`	Determine if MATLAB Runtime was started with instance of Java Virtual Machine (JVM)
`mclIsNoDisplaySet`	Determine if `-nodisplay` mode is enabled

C++ mwArray API

`mwArray`	Class used to pass input/output arguments to C++ functions generated by MATLAB Compiler SDK
`mwException`	Exception type used by the `mwArray` API and the C++ interface functions
`mwString`	String class used by the `mwArray` API to pass string data as output from certain methods

Topics

Create C++ mwArray API Shared Library

Generate a C++ mwArray API Shared Library and Build a C++ Application
Create a C++ mwArray API shared library from MATLAB code and implement it with sample C++ driver code.
Create C/C++ Shared Libraries from Command Line
Use the command-line compiler to create C/C++ shared libraries.

Integrate C++ Shared Library into C++ Application

Call MATLAB Compiler SDK API Functions from C/C++
Use MATLAB Compiler SDK™ shared library functions in C and C++ code.
Integrate C++ Shared Libraries with mwArray
Write C++ code to reference shared libraries that use the mwArray API.
Configure the mbuild Options File
How to configure the mbuild options file.
Use Multiple Shared Libraries in Single Application
Use multiple generated shared libraries in a single C/C++ application.

Mac OS X

Write Applications for macOS
Write deployable C++ applications specifically for macOS.

Maintenance

Memory Management and Cleanup
See recommendations on memory management.
Understand the mclmcrrt Proxy Layer
All application and software components generated by MATLAB Compiler™ and MATLAB Compiler SDK need to link against only one MATLAB library, mclmcrrt.
Compilation Failures
List of possible failures during compilation.
Testing Failures
List of possible failures during testing.
Deployment Failures
List of possible failures during deployment.

C++ mwArray API Shared Library Integration