mexPutVariable (Fortran)

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

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

#include "fintrf.h"
integer*4 mexPutVariable(workspace, varname, pm)
character*(*) workspace, varname
mwPointer pm

Аргументы

workspace

Задает возможности массива. Значения для workspace являются:

base

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

caller

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

global

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

varname

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

pm

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

Возвраты

0 на успехе; 1 при отказе. Возможной причиной отказа является то, что pm является 0.

Описание

Звонить 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.

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

См. также

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