Exponenta Banner
exponenta event banner

mxGetCell (C и 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 в случае успеха. В противном случае возвращает NULL в C (0 в Фортране). Причины отказа включают в себя:

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

  • Указание pm который не указывает на ячейку mxArray.

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

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

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

Описание

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

Примечание

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

Примеры

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

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

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

Поддержка