exponenta event banner

mxGetElitySize (Фортран)

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

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

Синтаксис Фортрана

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

Описание

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

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

Примечание

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

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

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

Указатель на mxArray, указано как mwPointer.

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

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

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

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

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

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

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

Возвращает 0 при сбое. Основной причиной отказа является то, что pm указывает на mxArray имеет нераспознанный класс.

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

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

В R2018b изменилось поведение

См. также

|

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