External Interfaces/API Reference

mexMakeArrayPersistent

Make an mxArray persist after the MEX-file completes

C Syntax

• #include "mex.h"
  void mexMakeArrayPersistent(mxArray *array_ptr);
  

Arguments

array_ptr
   Pointer to an mxArray created by an mxCreate* routine.

Description

By default, mxArrays allocated by mxCreate* routines are not persistent. The MATLAB memory management facility automatically frees nonpersistent mxArrays when the MEX-function finishes. If you want the mxArray to persist through multiple invocations of the MEX-function, you must call mexMakeArrayPersistent.

Note    If you create a persistent mxArray, you are responsible for destroying it when the MEX-file is cleared. If you do not destroy a persistent mxArray, MATLAB will leak memory. See mexAtExit to see how to register a function that gets called when the MEX-file is cleared. See mexLock to see how to lock your MEX-file so that it is never cleared.

See Also

mexAtExit, mexLock, mexMakeMemoryPersistent, and the mxCreate functions.

mexLock

mexMakeMemoryPersistent