The following functions allow you to determine the size of a variable or
expression. These functions are defined for all objects. They return
−1 when the operation doesn't make sense. For example, Octave's
data structure type doesn't have rows or columns, so the rows
and
columns
functions return −1 for structure arguments.
Return the number of dimensions of a. For any array, the result will always be larger than or equal to 2. Trailing singleton dimensions are not counted.
ndims (ones (4, 1, 2, 1)) ⇒ 3
Return the number of columns of a.
See also: rows, size, length, numel, isscalar, isvector, ismatrix.
Return the number of rows of a.
See also: columns, size, length, numel, isscalar, isvector, ismatrix.
Return the number of elements in the object a. Optionally, if indices idx1, idx2, ... are supplied, return the number of elements that would result from the indexing
a(idx1, idx2, ...)Note that the indices do not have to be numerical. For example,
a = 1; b = ones (2, 3); numel (a, b);will return 6, as this is the number of ways to index with b.
This method is also called when an object appears as lvalue with cs-list indexing, i.e.,
object{...}
orobject(...).field
.See also: size.
Return the "length" of the object a. For matrix objects, the length is the number of rows or columns, whichever is greater (this odd definition is used for compatibility with matlab).
Return the number of rows and columns of a.
With one input argument and one output argument, the result is returned in a row vector. If there are multiple output arguments, the number of rows is assigned to the first, and the number of columns to the second, etc. For example:
size ([1, 2; 3, 4; 5, 6]) ⇒ [ 3, 2 ] [nr, nc] = size ([1, 2; 3, 4; 5, 6]) ⇒ nr = 3 ⇒ nc = 2If given a second argument,
size
will return the size of the corresponding dimension. For example,size ([1, 2; 3, 4; 5, 6], 2) ⇒ 2returns the number of columns in the given matrix.
See also: numel.
Return true if a is an empty matrix (any one of its dimensions is zero). Otherwise, return false.
See also: isnull.
Return true if x is a special null matrix, string, or single quoted string. Indexed assignment with such a value on the right-hand side should delete array elements. This function should be used when overloading indexed assignment for user-defined classes instead of
isempty
, to distinguish the cases:
A(I) = []
- This should delete elements if
I
is nonempty.X = []; A(I) = X
- This should give an error if
I
is nonempty.