3.3 Размеры объектов ¶

Следующие функции позволяют определить размер переменной или выражения. Эти функции определены для всех объектов. Они возвращают −1, когда операция не имеет смысла. Например, тип структуры данных Octave не имеет строк или столбцов, поэтому функции rows и columns возвращают −1 для аргументов структуры.

: n = ndims (A) ¶

Возвращает число измерений A.

Для любого массива результат всегда будет больше или равен 2. Конечные одиночные измерения не учитываются, т.е., конечные измерения d, большие 2, для которых size (A, d) = 1.

ndims (ones (4, 1, 2, 1))
    ⇒ 3

См. также: size.

: nc = columns (A) ¶

Возвращает число столбцов A.

Это эквивалентно size (A, 2).

См. также: rows, size, length, numel, isscalar, isvector, ismatrix.

: nr = rows (A) ¶

Возвращает число строк A.

Это эквивалентно size (A, 1).

См. также: columns, size, length, numel, isscalar, isvector, ismatrix.

: n = numel (A) ¶

: n = numel (A, idx1, idx2, …) ¶

Возвращает число элементов в объекте A.

При необходимости, если заданы индексы idx1, idx2, …, возвращает количество элементов, которые бы получились в результате индексирования

A(idx1, idx2, ...)

Обратите внимание, что индексы не обязательно должны быть скалярными числами. Например,

a = 1;
b = ones (2, 3);
numel (a, b)

вернет 6, поскольку это количество способов индексирования с помощью b. Или индекс может быть строкой ":", которая представляет оператор двоеточия. Например,

A = ones (5, 3);
numel (A, 2, ":")

вернет 3, поскольку вторая строка имеет три столбца.

Этот метод также вызывается, когда объект появляется в качестве левой части с индексированием cs-списка, т.е., object{…} или object(…).field.

См. также: size, length, ndims.

: n = length (A) ¶

Возвращает длину объекта A.

Длина равна 0 для пустых объектов, 1 для скаляров и числу элементов для векторов. Для матриц или N-мерных объектов длина равна числу элементов вдоль наибольшего измерения (эквивалентно max (size (A))).

См. также: numel, size.

: sz = size (A) ¶

: dim_sz = size (A, dim) ¶

: dim_sz = size (A, d1, d2, …) ¶

: [rows, cols, …, dim_N_sz] = size (…) ¶

Возвращает строку-вектор с размером (числом элементов) каждого измерения для объекта A.

При задании второго аргумента dim, возвращает размер соответствующего измерения. Если dim является вектором, возвращает каждое соответствующее измерение. Также можно указать несколько измерений отдельными аргументами.

При одном выходном аргументе, size возвращает строку-вектор. При вызове с несколькими выходными аргументами, size возвращает размер измерения N в N-ом аргументе. Число строк, измерение 1, возвращается в первом аргументе, число столбцов, измерение 2, возвращается во втором аргументе и т.д. Если измерений в A больше, чем выходных аргументов, size возвращает общее количество элементов в оставшихся измерениях в последнем выходном аргументе. Если запрошенное измерение dim больше числа измерений в A, size возвращает 1 (а не 0).

Пример 1: строка-вектор с единственным выходным значением

size ([1, 2; 3, 4; 5, 6])
   ⇒ [ 3, 2 ]

Пример 2: количество элементов во втором измерении (столбцах)

size ([1, 2; 3, 4; 5, 6], 2)
    ⇒ 2

Пример 3: число выходных аргументов == число измерений

[nr, nc] = size ([1, 2; 3, 4; 5, 6])
    ⇒ nr = 3
    ⇒ nc = 2

Пример 4: число выходных аргументов < число измерений

[nr, remainder] = size (ones (2, 3, 4, 5))
    ⇒ nr = 2
    ⇒ remainder = 60

Пример 5: число элементов в измерении > числа фактических измерений

sz4 = size (ones (2, 3), 4)
    ⇒ sz4 = 1

См. также: numel, ndims, length, rows, columns, size_equal, common_size.

: tf = isempty (A) ¶

Возвращает true, если A является пустым объектом (любое из его измерений равно нулю).

См. также: isnull, isa.

: tf = isnull (x) ¶

Возвращает true, если x является специальным нулевым массивом, строкой или строкой в одинарных кавычках.

Индексированная присваивание с таким нулевым значением в правой части должно удалять элементы массива. Эта функция используется вместо isempty при перегрузке метода индексированного присваивания (subsasgn) для пользовательских классов. isnull используется для различения этих двух случаев:

A(I) = []

и

X = []; A(I) = X

В первом присваивании правая часть является [], что является специальным нулевым значением. Пока индекс I не пуст, этот код должен удалять элементы из A, а не выполнять присваивание.

Во втором присваивании правая часть является пустой (поскольку X является []), но не является нулевой. Этот код должен присвоить пустое значение элементам в A.

Пример из встроенного класса char Octave демонстрирует поведение интерпретатора, когда isnull используется правильно.

str = "Hello World";
nm = "Wally";
str(7:end) = nm                # indexed assignment
  ⇒ str = Hello Wally
str(7:end) = ""                # indexed deletion
  ⇒ str = Hello

См. также: isempty, isindex.

: sz = sizeof (val) ¶

Возвращает размер val в байтах.

См. также: whos.

: TF = size_equal (A, B) ¶

: TF = size_equal (A, B, …) ¶

Возвращает true, если размеры всех аргументов совпадают.

Конечные одиночные размеры игнорируются. При вызове с одним аргументом или без аргументов size_equal возвращает true.

См. также: size, numel, ndims, common_size.

: B = squeeze (A) ¶

Удаляет одиночные размеры из A и возвращает результат.

Обратите внимание, что для совместимости с MATLAB, все объекты имеют минимум два измерения, а строковые векторы остаются неизменными.

См. также: reshape.