Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

ndims

Number of array dimensions

Syntax

Description

example

N = ndims(A) returns the number of dimensions in the array A. The number of dimensions is always greater than or equal to 2. The function ignores trailing singleton dimensions, for which size(A,dim) = 1.

Examples

collapse all

Create a row vector.

A = 1:5;

Find the number of dimensions in the vector.

ndims(A)
ans =

     2

The result is 2 because the vector has a size of 1-by-5.

Create a cell array of character vectors.

A{1,1,1} = 'cell_1';
A{1,1,2} = 'cell_2';
A{1,1,3} = 'cell_3'
  1×1×3 cell array

A(:,:,1) = 

    'cell_1'


A(:,:,2) = 

    'cell_2'


A(:,:,3) = 

    'cell_3'

Find the number of dimensions of the cell array.

ndims(A)
ans =

     3

The result is 3 because the cell array has a size of 1-by-1-by-3.

Input Arguments

collapse all

Input array, specified as a scalar, vector, matrix, multidimensional array, table, or timetable.

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | cell | table | timetable | categorical | datetime | duration | calendarDuration

More About

collapse all

Tall Array Support

This function fully supports tall arrays. For more information, see Tall Arrays.

Algorithms

The number of dimensions in an array is the same as the length of the size vector of the array. In other words, ndims(A) = length(size(A)).

See Also

|

Introduced before R2006a

Was this topic helpful?