mxSetFieldByNumber (C and Fortran)

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

Синтаксис C

#include "matrix.h"
void mxSetFieldByNumber(mxArray *pm, mwIndex index,
  int fieldnumber, mxArray *pvalue);

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

#include "fintrf.h"
subroutine mxSetFieldByNumber(pm, index, fieldnumber, pvalue)
mwPointer pm, pvalue
mwIndex index
integer*4 fieldnumber

Аргументы

pm

Указатель на структуру mxArray. Вызвать mxIsStruct определить ли pm точки к структуре mxArray.

index

Индекс желаемого элемента.

В C, первом элементе mxArray имеет index из 0. index из последнего элемента N-1, где N число элементов в массиве. На Фортране, первом элементе mxArray имеет index из 1. index из последнего элемента N, где N число элементов в массиве.

Смотрите mxCalcSingleSubscript для получения дополнительной информации о вычислении индекса.

fieldnumber

Положение поля в структуре. Поле должно существовать в структуре.

В C первое поле в каждом элементе имеет fieldnumber из 0. fieldnumber из последнего N-1, где N количество полей.

На Фортране первое поле в каждом элементе имеет fieldnumber из 1. fieldnumber из последнего N, где N количество полей.

pvalue

Указатель на mxArray содержа данные вы хотите присвоить.

Описание

Использование mxSetFieldByNumber присваивать содержимое pvalue к полю, заданному fieldnumber из элемента index. mxSetFieldByNumber похож mxSetField; однако, функция идентифицирует поле номером положения, не по наименованию.

Если вы хотите заменить содержимое в fieldnumber, затем первый свободный память о существующих данных. Используйте mxGetFieldByNumber функция, чтобы получить указатель на поле, вызвать mxDestroyArray на указателе затем вызовите mxSetFieldByNumber присваивать новое значение.

Вы не можете присвоить pvalue больше чем к одному полю в структуре или больше чем к одному элементу в mxArray. Если вы хотите присвоить содержимое pvalue к нескольким полям затем используйте mxDuplicateArray функция, чтобы заставить копии данных затем вызвать mxSetFieldByNumber на каждой копии.

Чтобы освободить память для структур, созданных с помощью этой функции, вызвать mxDestroyArray только на массиве структур. Не вызывать mxDestroyArray на массиве pvalue точки к. Если вы делаете, то MATLAB^® попытки освободить ту же память дважды, которая может повредить память.

Примечание

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

Альтернативы

Язык C

В C, вызывая:

mxSetField(pa, index, "field_name", new_value_pa);

эквивалентно вызову:

field_num = mxGetFieldNumber(pa, "field_name");
mxSetFieldByNumber(pa, index, field_num, new_value_pa);

Язык Фортрана

На Фортране, вызывая:

mxSetField(pm, index, 'fieldname', newvalue)

эквивалентно вызову:

fieldnum = mxGetFieldNumber(pm, 'fieldname')
mxSetFieldByNumber(pm, index, fieldnum, newvalue)

Примеры

Смотрите эти примеры в matlabroot/extern/examples/mx:

mxcreatestructarray.c

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

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