mxSetProperty (C и Фортран)

Установите значение общественной собственности объекта 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 заданному свойству. В pseudo-C терминологии mxSetProperty выполняет присвоение:

pa[index].propname = value;

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

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

Ограничения

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

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

Введенный в R2008a

Была ли эта тема полезной?