mxGetElementSize (Fortran)

Количество байтов, требуемых сохранить каждый элемент данных

Для комплексного mxArray созданный с чередованным комплексным API, mxGetElementSize возвращает дважды значение, которое возвращает функция в отдельном комплексном API. Для получения дополнительной информации см. Вопросы совместимости.

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

#include "fintrf.h"
mwPointer mxGetElementSize(pm)
mwPointer pm

Описание

Вызвать mxGetElementSize определить количество байтов в каждом элементе данных mxArray. Например, если MATLAB® класс mxArray int16, mxArray хранилища каждый элемент данных как 16-битное (2-байтовое) целое число со знаком. Таким образом, mxGetElementSize возвращает 2.

mxGetElementSize полезно при использовании стандартной программы non-MATLAB, чтобы управлять элементами данных.

Примечание

Фортран не имеет эквивалента size_t. mwPointer макрос препроцессора, который обеспечивает соответствующий тип Фортрана. Значение, возвращенное этой функцией, однако, не является указателем.

Входные параметры

развернуть все

Указатель на mxArrayВ виде mwPointer.

Выходные аргументы

развернуть все

Количество байтов, требуемых сохранить один элемент заданного mxArray, возвращенный как integer*4.

Если pm комплексный числовой, затем данные в выходном аргументе зависят, на которой версии Матричного API Фортрана вы используете.

  • Если вы создаете с отдельным комплексным API (mex -R2017b опция), затем функция возвращает количество байтов для типа данных массива независимо, является ли массив комплексным или действительным.

  • Если вы создаете с чередованным комплексным API (mex -R2018a опция), затем возвращаемое значение является дважды количеством байтов для типа данных.

Если pm точки к ячейке или структуре, затем mxGetElementSize возвращает размер указателя. Функция не возвращает размер всех элементов в каждой ячейке или поле структуры.

Возвращается 0 на отказе. Основной причиной отказа является тот pm точки к mxArray наличие нераспознанного класса.

Вопросы совместимости

развернуть все

Поведение изменяется в R2018b

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

|

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