engGetFull (Obsolete) (External Interfaces Reference)

engGetFull (Obsolete)
This API function is obsolete and should not be used in a program that interfaces with MATLAB 5 or later.

Use

engGetVariable 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 = engGetVariable(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

engGetVariable and examples in the eng_mat subdirectory of the examples directory

engGetArray (Obsolete) engGetMatrix (Obsolete)