mexPutFull (MATLAB Application Program Interface)

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

m
Row dimension.

n
Column dimension.

name
Name of mxArray to put into workspace.

pi
Pointer to imaginary part.

pr
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.