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

• 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)