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 функция.

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

Входные параметры

расширить все

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

Имя mxArray в рабочем пространстве MATLAB, задается как const char *.

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

Примеры

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

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

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

См. также

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