External Interfaces Reference

mxDestroyArray

Free dynamic memory allocated by mxCreate

C Syntax

• #include "matrix.h"
  void mxDestroyArray(mxArray *array_ptr);
  

Arguments

array_ptr
   Pointer to the mxArray that you want to free.

Description

mxDestroyArray deallocates the memory occupied by the specified mxArray. mxDestroyArray not only deallocates the memory occupied by the mxArray's characteristics fields (such as m and n), but also deallocates all the mxArray's associated data arrays (such as pr, pi, ir, and/or jc). You should not call mxDestroyArray on an mxArray you are returning on the left-hand side.

Examples

See sincall.c in the refbook subdirectory of the examples directory.

For additional examples, see mexcallmatlab.c and mexgetarray.c in the mex subdirectory of the examples directory; see mxisclass.c in the mx subdirectory of the examples directory.

See Also

mxCalloc, mxFree, mexMakeArrayPersistent, mexMakeMemoryPersistent

mxCreateStructMatrix

mxDuplicateArray

© 1994-2005 The MathWorks, Inc.