Exponenta Banner

mxGetCell (C and Fortran)

Указатель на элемент в массиве ячеек

Синтаксис C

#include "matrix.h"
mxArray *mxGetCell(const mxArray *pm, mwIndex index);

Синтаксис языка ФОРТРАН

#include "fintrf.h"
mwPointer mxGetCell(pm, index)
mwPointer pm
mwIndex index

Аргументы

pm

Указатель на камеру mxArray

index

Количество элементов в камеру mxArray между первым элементом и желаемым элементом. Посмотрите mxCalcSingleSubscript для получения дополнительной информации об вычислении индекса в многомерном массиве ячеек.

Возвраты

Указатель на ith-я камерой mxArray в случае успеха. В противном случае возвращается NULL в C (0 на Фортране). Причины отказа включают:

  • Указание индекса элемента массива ячеек, который не был заполнен.

  • Определение pm это не указывает на камеру mxArray.

  • Определение index к элементу за пределами mxArray.

  • Недостаточно пространства в куче.

Не звонить mxDestroyArray на mxArray возвращен mxGetCell функция.

Описание

Звонить mxGetCell чтобы получить указатель на mxArray удерживается в индексированном элементе камеры mxArray.

Примечание

Входы в файл MEX являются постоянными mxArray только для чтенияs. Не изменяйте входы. Используя mxSetCell* или mxSetField* функции для изменения камер или полей MATLAB® аргумент приводит к непредсказуемым результатам.

Примеры

См. эти примеры в matlabroot/ extern/examples/mex:

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

Документация MATLAB

Поддержка