mxSetProperty (C and 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. The index последнего элемента N-1, где N - количество элементов в массиве. В Фортране первый элемент mxArray имеет index от 1. The index последнего элемента N, где N - количество элементов в массиве.

propname

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

значение

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

Описание

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

pa[index].propname = value;

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

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

Ограничения

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

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

Введенный в R2008a