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

Поместите переменную в рабочую область движка MATLAB

Синтаксис C

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

Синтаксис языка ФОРТРАН

#include "engine.h"
integer*4 engPutVariable(ep, name, pm)
mwPointer ep, pm
character*(*) name

Аргументы

ep

Указатель Engine

name

Имя mxArray в рабочей области механизма

pm

Указатель mxArray

Возвращается

0, если успешный и 1, если ошибка происходит.

Описание

engPutVariable пишет mxArray pm в механизм ep, давая ему имя переменной name.

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

Предел для размера переданных данных составляет 2 Гбайт.

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

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

Примеры

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

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

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

Смотрите также

engGetVariable

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

Для просмотра документации необходимо авторизоваться на сайте