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. MATLAB's memory management facility automatically frees nonpersistent mxArrays when the MEX-file finishes. If you want the mxArray to persist through multiple invocations of the MEX-file, 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 the 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