External Interfaces/API Reference

matGetFull (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

matGetArray followed by the appropriate mxGet routines

instead of

matGetFull

For example,

int matGetFull(MATFile *fp, char *name, int *m, int *n, 
               double **pr, double **pi)
{
    mxArray *parr;
    /* Get the matrix. */
    parr = matGetArray(fp, name);

    if (parr == NULL)
        return(1);

    if (!mxIsDouble(parr)) {
        mxDestroyArray(parr);
        return(1);
    }
    /* Set up return args. */

    *m  = mxGetM(parr);
    *n  = mxGetN(parr);
    *pr = mxGetPr(parr);
    *pi = mxGetPi(parr);
    /* Zero out pr & pi in array struct so the mxArray can be
       destroyed. */
    mxSetPr(parr, (void *)0);
    mxSetPi(parr, (void *)0);

    mxDestroyArray(parr);

    return(0);
}

See Also

matGetArray

matGetFp

matGetMatrix (Obsolete)