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 для получения дополнительной информации о вычислении индекса в многомерном массиве ячеек.

Возвращается

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

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

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

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

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

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

Описание

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

Примечание

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

Примеры

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

Смотрите также

mxCreateCellArray, mxIsCell, mxSetCell

Представлено до R2006a
Для просмотра документации необходимо авторизоваться на сайте