mxSetPr (Fortran)
(Not recommended) Set real data elements in mxDOUBLE_CLASS
array
mxSetPr
is not available in the interleaved complex API. Use
mxSetDoubles
or mxSetComplexDoubles
instead. For more information, see Version History.
Fortran Syntax
#include "fintrf.h" subroutine mxSetPr(pm, pr) mwPointer pm, pr
Description
The mxSetPr
function sets the real data of a real
mxDOUBLE_CLASS
array pm
. If you build with the
interleaved complex API (mex
-R2018a
option) and pm
is complex, then the
function terminates the MEX file and returns control to the MATLAB® prompt. In a non-MEX file application, the function returns
0
.
Call mxIsDouble
to validate the
mxArray
type. Call mxIsComplex
to determine whether the
data is real.
All mxCreate
* functions allocate heap space to hold data.
Therefore, you do not ordinarily use this function to initialize the real elements of an
array. Instead, call this function to replace the existing values with new
values.
The mxSetPr
function does not free memory allocated for existing
data. To free existing memory, call mxFree
on the pointer returned
by mxGetPr
.