mxGetData (Fortran)

Data elements in nonnumeric mxArray

mxGetData is not recommended for numeric arrays. Use typed, data-access functions instead. For more information, see Version History.

Fortran Syntax

#include "fintrf.h"
mwPointer mxGetData(pm)
mwPointer pm

Description

Use mxGetData to get data elements for nonnumeric arrays only.

For numeric arrays, MathWorks recommends that you create MEX files and update existing MEX files to use the typed, data-access functions in the interleaved complex API. For more information, see:

• Typed Data Access in C MEX Files

• MATLAB Support for Interleaved Complex API in MEX Functions

• Upgrade MEX Files to Use Interleaved Complex API

To build the MEX file, call mex with the -R2018a option.

Input Arguments

pm — Pointer to nonnumeric MATLAB^® array

mwPointer

Pointer to a nonnumeric MATLAB array, specified as mwPointer.

Output Arguments

pa — Pointer to data array

mwPointer | 0

Pointer to the data array within an mxArray, specified as mwPointer. Since void pointers point to a value that has no type, cast the return value to the pointer type that matches the type specified by pm.

To copy values from the returned pointer, use one of the mxCopyPtrTo* functions. For example:

C      Get the data in mxArray, pm
       mxCopyPtrToReal8(mxGetData(pm),data,
     +                  mxGetNumberOfElements(pm))

If pm is 0, then the function returns 0.

Version History

Introduced before R2006a

R2018b: For complex numeric mxArray, casting mxGetData return value depends on build option

The mxGetData function returns mwPointer. Your code must declare a pointer type that matches the type specified by the mxArray input argument. For complex numeric input, the correct type depends on the build option used to create the MEX file.

If you build the MEX file with the default release-specific option (-R2017b), then the function returns a pointer to the first element of the real-only values.

If you build the MEX file with the -R2018a option, then:

• When input argument pm points to a real MATLAB array, the function returns a pointer to the first element of the data.

• When pm is a complex array, the function returns a pointer to the first element of the interleaved real and imaginary values, not to the real-only values.