engGetFull (Obsolete) (MATLAB Application Program Interface)

V4 Compatible

This function is obsolete; it should not appear in a MATLAB 5 program. To use this function in existing code, use the -V4 option of the mex script.

In MATLAB 5 engine applications, call

engGetArray followed by appropriate mxGet routines (mxGetM, mxGetN, 
mxGetPr, mxGetPi)

For example,

int engGetFull(
    Engine       *ep,    /* engine pointer */
    char         *name,  /* full array name */
    int          *m,     /* returned number of rows */
    int          *n,     /* returned number of columns */
    double       **pr,   /* returned pointer to real part */
    double       **pi    /* returned pointer to imaginary part */
    )
{
    mxArray      *pmat;

    pmat = engGetArray(ep, name);

    if (!pmat)
            return(1);

    if (!mxIsDouble(pmat)) {
            mxDestroyArray(pmat);
            return(1);
    }

    *m  = mxGetM(pmat);
    *n  = mxGetN(pmat);
    *pr = mxGetPr(pmat);
    *pi = mxGetPi(pmat);

    /* Set pr & pi in array struct to NULL so it can be cleared. */
    mxSetPr(pmat, NULL);
    mxSetPi(pmat, NULL);

    mxDestroyArray(pmat);

    return(0);
}