BuildMATLABInterface to C++ Library

To create a MATLAB^®interface to a C++ library, use the MATLABclibgenpackage

To build (publish) a MATLAB interface to a C++ library, seeSteps to Publish a MATLAB Interface to a C++ Library.

For information about calling functions in the library from MATLAB, seeUse Prebuilt MATLAB Interface to C++ Library.

Functions

`clibgen.generateLibraryDefinition`	Create definition file for C++ library
`clibgen.buildInterface`	Create interface to C++ library without definition file

clibgen Package Summary of packages and classes to support calling C++ library functionality fromMATLAB

What Types of Files Define Your Library?
How to set the arguments to theclibgen.generateLibraryDefinitionfunction.
Steps to Publish a MATLAB Interface to a C++ Library
Outline for publishing an interface to a C++ library.
Requirements for Building Interface to C++ Libraries
Requirements for calling functions in external, shared C++ libraries from MATLAB.
Distribute MATLAB Interface to C++ Library
How to share your MATLAB interface with MATLAB users.

Header File and Import Library File on Windows
This example creates a MATLAB interface to a C++ library with an import library filematrixOperations.lib.
- STEP 1:Generate Interface on Windows
- STEP 2:Define Missing Constructs
- STEP 3:Build Interface
- STEP 4:Call Library Functions on Windows
Header File and Shared Object File on Linux
This example creates a MATLAB interface to a C++ library with a shared object filelibmwmatrixOperations.so.
- STEP 1:Generate Interface on Linux
- STEP 2:Define Missing Constructs
- STEP 3:Build Interface
- STEP 4:Call Library Functions on Linux
Header File and Dynamic Shared Library File on macOS
This example creates a MATLAB interface to a C++ library with a dynamic shared library filelibmwmatrixOperations.dylib.
- STEP 1:Generate Interface on macOS
- STEP 2:Define Missing Constructs
- STEP 3:Build Interface
- STEP 4:Call Library Functions on macOS

Header and CPP Source Files
This example creates a MATLAB interface to a C++ library defined in source filesmatrixOperations.hppandmatrixOperations.cpp.
- STEP 1:Generate Interface
- STEP 2:Define Missing Constructs
- STEP 3:Build Interface to matrixoperations Library
- STEP 4:Call matrixoperations Library Functions
Header-Only HPP File
This example creates a MATLAB interface to a C++ library defined in a header fileschool.hpp.
- STEP 1:Generate Interface to school Library
- STEP 2:Define Missing Constructs in Interface to school Library
- STEP 3:Build Interface to school Library
- STEP 4:Call school Library Functions

Define MATLAB Interface for C++ Library
Generate and edit the MATLABMLXlibrary definition file to customize and define the interface.
Publish Help Text for MATLAB Interface to C++ Library
Provide documentation for end-users of a MATLAB interface to a C++ Library.
- Modify Library Help
C++ to MATLAB Data Type Mapping
Correspondence of MATLAB data types to C/C++ types.
Lifetime Management of C++ Objects in MATLAB
MATLAB rules for managing memory for C++ objects created in a MATLAB interface to a C++ shared library.
Initialize Pointer Members of C++ Structures for MATLAB Interface to Library
Verify that C++ class constructors initialize pointer members.

If library functionality is missing, the library might contain unsupported language features or data types.

C/C++ library features not supported in MATLAB.

Information for resolving error when publishing a MATLAB interface to a C++ library.