mxGetNumberOfDimensions (C)

Number of dimensions in mxArray

C Syntax

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

Description

mxGetNumberOfDimensions returns the number of dimensions in the specified mxArray. The returned value is always 2 or greater.

To determine how many elements are in each dimension, call mxGetDimensions.

Input Arguments

pm — MATLAB array

const mxArray*

Pointer to an mxArray array, specified as const mxArray*.

Examples

To open an example, type:

edit([fullfile(matlabroot,"extern","examples","mex","filename")]);

where filename is:

• explore.c

To open an example, type:

edit([fullfile(matlabroot,"extern","examples","refbook","filename")]);

where filename is:

• findnz.c

• fulltosparse.c

• phonebook.c

To open an example, type:

edit([fullfile(matlabroot,"extern","examples","mx","filename")]);

where filename is:

• mxcalcsinglesubscript.c

• mxgeteps.c

• mxisfinite.c

Version History

Introduced before R2006a