engPutVariable (C and Fortran)

Поместите переменную в рабочую область движка 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® в именах переменных. Общие имена переменных, которые конфликтуют с именами функций, включают iJрежим'char'размер, или path. Чтобы определить, сопоставлено ли конкретное имя с функцией MATLAB, используйте which функция.

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

Примеры

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

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

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

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

engGetVariable

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

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