exponenta event banner

mxSetDimensions (Фортран)

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

Синтаксис Фортрана

#include "fintrf.h"
integer*4 mxSetDimensions(pm, dims, ndim)
mwPointer pm
mwSize ndim
mwSize dims(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 массив, указанный как mwPointer.

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

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

Примеры

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

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