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

Входной параметр prhs

mxArray переданный файлу MEX через prhs входной параметр существует вне осциллографа файла MEX. Не освобождайте память ни для какого mxArray в prhs параметр. Кроме того, prhs переменные только для чтения; не изменяйте их в своем файле MEX.

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

Если вы создаете mxArray (выделите память и создайте данные) для выходного аргумента память и данные существуют вне осциллографа файла MEX. Не освобождайте память на mxArray возвращенный в plhs выходной параметр.

Локальная переменная

Вы выделяете память каждый раз, когда вы используете mxCreate* функция, чтобы создать mxArray или когда вы вызываете mxCalloc и присоединенные функции. После наблюдения правил для обработки аргументов ввода и вывода файл MEX должен уничтожить временные массивы и свободную динамически выделенную память. Чтобы освободить память, используйте любой mxDestroyArray или mxFree. Для получения информации о который функция использовать, см. MX Matrix Library.

Комплекс с двойной точностью матрицы

Наиболее распространенный тип данных в MATLAB является комплексной двойной точностью, неразреженной матрицей. Эти матрицы имеют тип double и имейте размерности m- n, где m количество строк и n количество столбцов. Данные хранятся как вектор чередованных, чисел с двойной точностью, где действительные и мнимые части хранятся друг рядом с другом. Указатель на эти данные упоминается как pa (указатель на массив). Чтобы протестировать на некомплексную матрицу, вызовите mxIsComplex.

Перед MATLAB Version 9.4 (R2018a) MATLAB использовал представление отдельной системы хранения. Данные хранятся как два вектора чисел с двойной точностью — каждый содержит действительные данные, и каждый содержит мнимые данные. Указатели на эти данные упоминаются как pr (указатель на действительные данные) и pi (указатель на мнимые данные), соответственно. Некомплексная матрица является той чей pi isNull. Однако, чтобы протестировать на некомплексную матрицу, вызовите mxIsComplex.

Другие числовые матрицы

MATLAB поддерживает с одинарной точностью с плавающей точкой и 8-, 16-, 32-, и 64-битные целые числа, оба подписанные и без знака.

Логические матрицы

Логический тип данных представляет логический true или false состояние с помощью чисел 1 и 0, соответственно. Определенные функции MATLAB и операторы возвращают логический 1 или логический 0 указать, как ли определенное условие, находили, было верно или нет. Например, оператор (5 * 10) > 40 возвращает логический 1 значение.

MATLAB char Массивы

MATLAB char массивы хранят данные как 16-битные целые числа без знака. Преобразовывать char MATLAB массив к строке C-стиля, вызовите mxArrayToString. Преобразовывать строку C-стиля в char массив, вызовите mxCreateString.

Массивы ячеек

Массивы ячеек являются набором массивов MATLAB где каждый mxArray упоминается как ячейка. Массивы ячеек позволяют массивам MATLAB различных типов храниться вместе. Массивы ячеек хранятся подобным образом к числовым матрицам, кроме данных, фрагмент содержит один вектор указателей на mxArrays. Члены этого вектора называются ячейками. Каждая ячейка может иметь любой поддерживаемый тип данных, даже другой массив ячеек.

Структуры

1- 1 структура хранится таким же образом как 1- n массив ячеек, где n количество полей в структуре. Члены вектора данных называются полями. Каждое поле сопоставлено с именем, сохраненным в mxArray.

Объекты

Объекты хранятся и получили доступ к тому же пути как структуры. В MATLAB объекты называют структурами с зарегистрированными методами. Вне MATLAB объект является структурой, которая содержит устройство хранения данных для дополнительного имени класса, которое идентифицирует имя объекта.

Многомерные массивы

Массивы MATLAB любого типа могут быть многомерными. Вектор целых чисел хранится, где каждым элементом является размер соответствующей размерности. Метод устройства хранения данных данных эквивалентен для матриц.

Пустые массивы

Массивы MATLAB любого типа могут быть пустыми. Пустой mxArray один по крайней мере с одной равной нулю размерностью. Например, mxArray с двойной точностью из типа double, где m и n равняйтесь 0 и pa isNull, пустой массив.

Объявление структур данных

Чтобы обработать массивы MATLAB, используйте, вводят mxArray. Следующий оператор объявляет mxArray названный myData:

mxArray *myData;

Задавать значения myData, используйте один из mxCreate* функции. Некоторыми полезными стандартными программами создания массивов является mxCreateNumericArray, mxCreateCellArray, и mxCreateCharArray. Например, следующий оператор выделяет m- 1 mxArray с плавающей точкой инициализированный к 0:

myData = mxCreateDoubleMatrix(m, 1, mxREAL);

Программисты C/C++ должны отметить, что данные в массиве MATLAB находятся в порядке развертывания по столбцам. (Для рисунка смотрите Хранение данных.) Используют mxGet* MATLAB стандартные программы доступа к массиву, чтобы считать данные из mxArray.

Управление данными

mxGet* стандартные программы доступа к массиву получают ссылки на данные в mxArray. Используйте эти стандартные программы, чтобы изменить данные в вашем файле MEX. Каждая функция обеспечивает доступ к определенной информации в mxArray. Некоторыми полезными функциями является mxGetDoubles, mxGetComplexDoubles, mxGetM, и mxGetString. Многие из этих функций имеют соответствующий mxSet* стандартные программы, чтобы позволить вам изменять значения в массиве.

Следующие операторы читают вход prhs[0] в C-стиль представляют в виде строки buf.

char *buf;
int buflen;
int status;
buflen = mxGetN(prhs[0])*sizeof(mxChar)+1;
buf = mxMalloc(buflen);
status = mxGetString(prhs[0], buf, buflen);

explore Пример

Существует исходный файл MEX в качестве примера, включенный с MATLAB, названным explore.c, это идентифицирует тип данных входной переменной. Исходный код для этого примера находится в matlabroot/extern/examples/mex, где matlabroot представляет папку верхнего уровня, где MATLAB установлен в вашей системе.

Чтобы создать файл MEX в качестве примера, сначала скопируйте файл в перезаписываемую папку на вашем пути.

copyfile(fullfile(matlabroot,'extern','examples','mex','explore.c'),'.','f')

Используйте mex команда, чтобы создать файл MEX.

mex explore.c -R2018a

Ввод:

x = 2;
explore(x)

------------------------------------------------
Name: prhs[0]
Dimensions: 1x1 
Class Name: double
------------------------------------------------
	(1,1) = 2

explore принимает любой тип данных. Попытайтесь использовать explore с этими примерами:

explore([1 2 3 4 5])
explore 1 2 3 4 5
explore({1 2 3 4 5})
explore(int8([1 2 3 4 5]))
explore {1 2 3 4 5}
explore(sparse(eye(5)))
explore(struct('name', 'Joe Jones', 'ext', 7332))
explore(1, 2, 3, 4, 5)
explore(complex(3,4))