mxGetCell (C и Фортран)

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

Синтаксис 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 th ячейка mxArray в случае успеха. В противном случае, возвращает 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

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