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