Learn more about MATLAB

mxGetDimensions (C and Fortran) - Get pointer to dimensions array

C Syntax

#include "matrix.h"
const mwSize *mxGetDimensions(const mxArray *pm);

Fortran Syntax

mwPointer mxGetDimensions(pm)
mwPointer pm

Arguments

pm

Pointer to an mxArray.

Returns

Pointer to the first element in the dimensions array. Each integer in the dimensions array represents the number of elements in a particular dimension. The array is not NULL terminated.

Description

Use mxGetDimensions to determine how many elements are in each dimension of the mxArray that pm points to. Call mxGetNumberOfDimensions to get the number of dimensions in the mxArray.

To copy the values to Fortran, use mxCopyPtrToInteger4 in the following manner:

C      Get dimensions of mxArray, pm
       mxCopyPtrToInteger4(mxGetDimensions(pm), dims,  
     +                      mxGetNumberOfDimensions(pm))

C Examples

See mxcalcsinglesubscript.c in the matlabroot/extern/examples/mx folder .

Additional examples:

• findnz.c and phonebook.c in the matlabroot/extern/examples/refbook folder

• explore.c in the matlabroot/extern/examples/mex folder

• mxgeteps.c and mxisfinite.c in the matlabroot/extern/examples/mx folder

See Also

mxGetNumberOfDimensions

mxGetData (C and Fortran)

mxGetElementSize (C and Fortran)

© 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS