MATLAB Application Program Interface Reference Help Desk

mxGetM

Purpose

Get the number of rows

C Syntax

Arguments

array_ptr

Pointer to an array.

Returns

The number of rows in the mxArray to which array_ptr points.

Description

mxGetM returns the number of rows in the specified array. The term "rows" always means the first dimension of the array no matter how many dimensions the array has. For example, if array_ptr points to a four-dimensional array having dimensions 8-by-9-by-5-by-3, then mxGetM returns 8.

Examples

Consider a MEX-file that accepts two input mxArray arguments. Both mxArray arguments must have the same number of rows in order for the calculation to work.

For an additional example, see mxGetM.c in the mx subdirectory of the examples directory.

See Also

mxGetN, mxSetM, mxSetN



[ Previous | Help Desk | Next ]