External Interfaces/API Reference

engGetFull (Obsolete)

This API function is obsolete and should not be used in a program that interfaces with MATLAB 5 or later. This function may not be available in a future version of MATLAB. If you need to use this function in existing code, use the -V4 option of the mex script.

Use

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

instead of

engGetFull

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);
}

See Also

engGetArray and examples in the eng_mat subdirectory of the examples directory

engGetArray

engGetMatrix (Obsolete)