exponenta event banner

mexPutVariable (C)

Массив из функции MEX в указанную рабочую область

Синтаксис C

#include "mex.h"
int mexPutVariable(const char *workspace, const char *varname, 
  const mxArray *pm);

Описание

Примечание

Сведения о записи функций MEX с использованием современных функций C++ и интерфейса MATLAB Data API см. в разделе Приложения C++ MEX.

Звонить mexPutVariable для копирования mxArray, у указателя pm, из функции MEX в указанную рабочую область. MATLAB ® присваиваетvarname в mxArray скопировано в рабочую область.

mexPutVariable делает массив доступным для других объектов, таких как MATLAB, пользовательские функции или другие функции MEX.

Если переменная с таким именем существует в указанной рабочей области, mexPutVariable перезаписывает предыдущее содержимое переменной на содержимое нового mxArray. Например, предположим, что рабочая область MATLAB определяет переменную Peaches как:

Peaches
1     2     3     4

и вы звоните mexPutVariable скопировать Peaches в ту же рабочую область:

mexPutVariable("base", "Peaches", pm)

Переданное значение mexPutVariable заменяет старое значение Peaches.

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

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

Область массива для копирования, указанная как const char*. Возможные значения:

base

Копия mxArray в базовое рабочее пространство.

caller

Копия mxArray в рабочую область вызывающего абонента.

global

Копия mxArray в список глобальных переменных.

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

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

Указатель на mxArray.

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

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

Состояние, возвращено как 0 об успехе. Прибыль 1 при отказе. Возможной причиной отказа является то, что pm является NULL.

Примеры

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

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