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

• matGetVariable 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 = matGetVariable(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

matGetVariable

matGetFp

matGetMatrix (Obsolete)