Using the C Math Library

Restrictions 

Routines that use the MATLAB C Math Library's automated memory management can only call other routines written with automated memory management. This includes any of the MATLAB C Math Library Version 2.0 functions.

Routines that use automated memory management cannot call functions that use explicit memory management, for example, routines written with the MATLAB C Math Library prior to Version 2.0.

Note    Functions written with or without automated memory management can call your function.

If you write a new function that does not use the library's automated memory management, you can:

• Call a function that you wrote with the MATLAB C Math Library prior to Version 2.0
• Call a new function that you've written with or without automated memory management
• Call MATLAB C Math Library Version 2.0 functions

Note    Functions written without automated memory management can call your function; functions written with automated memory management cannot.

Recommendation

Though the explicit approach seems to offer flexibility, you lose the benefits of the library's automated memory management.

Mixing memory management styles is not recommended. Choose one style or the other. Use the mlfEnterNewContext() and mlfRestorePreviousContext() pair and mlfAssign() for all your functions or none of your functions.

Note    Some functions have changed between Version 1.2 and Version 2.0 of the library. You must update any calls in existing code to the group of functions that have a different prototype for Version 2.0 of the MATLAB C Math Library. See the release notes, release.txt, in the <matlab>/extern/examples/cmath directory of your installation for a list of these functions.

Example Without Automated Memory Management

Replacing Allocation and Deallocation Routines