exponenta event banner

engPutVariable (C)

Поместить переменную в рабочее пространство механизма MATLAB

Синтаксис C

#include "engine.h"
int engPutVariable(Engine *ep, const char *name, const mxArray *pm);

Описание

engPutVariable пишет mxArray pm к двигателю ep, давая ему имя переменной name. Прибыль 0 в случае успеха и 1 при возникновении ошибки.

Если mxArray не существует в рабочей области, ее создает функция. Если mxArray с таким же именем существует в рабочей области, функция заменяет существующую mxArray с новым mxArray.

Предельный размер передаваемых данных - 2 ГБ.

Не используйте имена функций MATLAB ® для имен переменных. Общие имена переменных, конфликтующие с именами функций: i, j, mode, char, size, или path. Чтобы определить, связано ли конкретное имя с функцией MATLAB, используйте which функция.

Приложению движка принадлежит оригинал mxArray и отвечает за освобождение своей памяти. Хотя engPutVariable функция отправляет копию mxArray в рабочей области MATLAB приложению обработчика не требуется учитывать или освобождать память для копии.

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

развернуть все

Указатель на двигатель, указанный как Engine *.

Наименование mxArray в рабочей области MATLAB, указанной как const char *.

Указатель на mxArray, указанный как const mxArray *.

Примеры

См. эти примеры в разделе matlabroot/extern/examples/eng_mat:

  • engdemo.c для примера C в операционных системах UNIX ®.

  • engwindemo.c пример C в операционных системах Microsoft ® Windows ®.

См. также

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