MATLAB Application Program Interface Reference

Routine to create an mxArray from its component parts into a Fortran workspace

integer*4 function mexPutFull(name, m, n, pr, pi)
integer*4 m, n, pr, pi
character*(*) name

Arguments

Row dimension.

Column dimension.

name

Name of mxArray to put into workspace.

Pointer to imaginary part.

Pointer to real part.

Returns

0 if successful, and 1 otherwise.

Description

Most MATLAB applications work only with full (nonsparse) mxArrays. mexPutFull provides an easy way to write a full mxArray into a MEX-file's caller's workspace. It is an alternative to mexPutMatrix, which requires use of the mxArray structure.

mexPutFull writes the mxArray with dimensions m-by-n, real data pr, and imaginary data pi into the calling workspace with the specified name. If an mxArray with the same name already exists in the workspace, the existing mxArray is replaced with the new one.