exponenta event banner

mxSetDimensions (C)

Изменение количества размеров и размера каждого размера

Синтаксис C

#include "matrix.h"
int mxSetDimensions(mxArray *pm, const mwSize *dims, mwSize ndim);

Описание

mxSetDimensions прибыль 0 об успехе, и 1 при отказе. mxSetDimensions выделяет кучное пространство для хранения массива входных размеров. Таким образом, возможно (хотя и маловероятно), что увеличение количества размеров может привести к тому, что система исчерпает кучное пространство.

Звонить mxSetDimensions изменение формы существующего mxArray. mxSetDimensions это как mxSetM и mxSetN; однако, mxSetDimensions обеспечивает больший контроль за изменением формы mxArray имеет более двух измерений.

mxSetDimensions не выделяет и не освобождает место для pr или pi массивы. Итак, если ваш звонок mxSetDimensions увеличивает количество элементов в mxArray, затем увеличить prpi, если он существует) соответственно создает массивы.

Если ваш звонок на mxSetDimensions уменьшает количество элементов в mxArray, то можно дополнительно уменьшить размер pr и pi массивы с использованием mxRealloc.

MATLAB ® автоматически удаляет любые конечные одиночные размеры, указанные в dims аргумент. Например, если ndim равняется 5 и dims равняется [4 1 7 1 1], то результирующий массив имеет размеры 4около-1около-7.

Входные аргументы

развернуть все

Указатель на mxArray массив, указанный как const mxArray*.

Массив размеров. Каждый элемент в массиве измерений содержит размер массива в этом измерении, указанный как mwSize. Например, в Fortran, настройка dims(1) кому 5 и dims(2) кому 7 устанавливает 5около-7 mxArray. В большинстве случаев существуют ndim элементы в dims массив.

Количество размеров, указанное как mwSize.

Примеры

См. эти примеры в разделе matlabroot/extern/examples/mx:

Представлен до R2006a