C Shared Library Integration

Integrate packaged MATLAB^® functions into C applications

MATLAB Compiler SDK™ enables you to create C shared libraries from MATLAB functions.

Shared libraries that use the mxArray 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 code and the MATLAB Runtime. For an example, see Create a C Shared Library with MATLAB Code.

Functions

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

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

Topics

Create and Implement a C Shared Library

Install an ANSI C or C++ Compiler
Install a supported C/C++ compiler.
Create a C Shared Library with MATLAB Code
Learn how to create a C shared library.
Create C/C++ Shared Libraries from Command Line
Use the command-line compiler to create C/C++ shared libraries.

Integrate a C Shared Library with a C Driver Application

Call a C Shared Library
Use one or more MATLAB Compiler SDK generated C shared libraries in your C application.
Call MATLAB Compiler SDK API Functions from C/C++
Use MATLAB Compiler SDK shared library functions in C and C++ code.
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.

Troubleshooting C Shared Libraries

Compilation Failures
List of possible failures during compilation.
Testing Failures
List of possible failures during testing.
Deployment Failures
List of possible failures during deployment.
Troubleshoot mbuild
Issues involving the mbuild utility and creating standalone applications.