mexPutFull (MATLAB Application Program Interface)

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

Fortran Syntax

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

Arguments

name
Name of mxArray to put into workspace.

m
Row dimension.

n
Column dimension.

pr
Pointer to real part.

pi
Pointer to imaginary 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.