mxCreateStructMatrix (C)

2-D массив структур

Синтаксис C

#include "matrix.h"
mxArray *mxCreateStructMatrix(mwSize m, mwSize n, int nfields, const char **fieldnames);

Описание

Звонить mxCreateStructMatrix для создания незаселенной, двумерной структуры mxArray. Для получения информации о структуре см. mxCreateStructArray.

Звонить mxDestroyArray когда вы заканчиваете использовать mxArray для удаления mxArray и связанные с ним элементы.

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

расширить все

Количество строк, заданное как mwSize.

Количество столбцов в виде mwSize.

Количество полей в каждом элементе, заданное как int.

Одно или несколько имен полей, заданные как const char **.

Имена полей должны быть допустимыми MATLAB® идентификаторы, что означает, что они не могут быть NULL или пустой. Имена полей зависят от регистра. Чтобы определить максимальную длину имени поля, используйте namelengthmax функция.

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

расширить все

Указатель на mxArray, заданный как mxArray *, в случае успеха.

Функция неудачна, когда не хватает свободного пространства в куче, чтобы создать mxArray.

  • Файл MEX - Function завершает Файл MEX и возвращает управление в подсказку MATLAB.

  • Автономное (не-MEX файл) приложение - Функция возвращает 0.

Примеры

См. эти примеры в matlabroot/ extern/examples/refbook:

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