exponenta event banner

mxSetProperty (C и Fortran)

Задать значение общего свойства объекта MATLAB

Синтаксис C

#include "matrix.h"
void mxSetProperty(mxArray *pa, mwIndex index,
  const char *propname, const mxArray *value);

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

#include "fintrf.h"
subroutine mxSetProperty(pa, index, propname, value)
mwPointer pa, value
mwIndex index
character*(*) propname

Аргументы

pa

Указатель на mxArray который является объектом.

index

Индекс требуемого элемента массива объектов.

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

propname

Имя свойства, значение которого присваивается.

стоимость

Указатель на mxArray вы назначаете.

Описание

Использовать mxSetProperty для назначения value к указанному свойству. В псевдо-C терминологии mxSetProperty выполняет назначение:

pa[index].propname = value;

Собственность propname должны быть существующей, публичной собственностью и index должны находиться в пределах границ mxArray. Для проверки значения индекса используйте mxGetNumberOfElements или mxGetM и mxGetN функции.

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

Ограничения

  • mxSetProperty не поддерживается для автономных приложений, таких как приложения, построенные с помощью API MATLAB ® engine.

  • Свойства типа datetime не поддерживаются.

Представлен в R2008a