Exponenta Banner
exponenta event banner

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

Указатель только для чтения на переменную из другой рабочей области

Синтаксис C

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

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

#include "fintrf.h"
mwPointer mexGetVariablePtr(workspace, varname)
character*(*) workspace, varname

Аргументы

workspace

Задает, какую рабочую область вы хотите, чтобы mexGetVariablePtr искал. Возможные значения:

base

Ищите переменную в базовом рабочем пространстве.

caller

Ищите переменную в рабочей области вызывающей стороны.

global

Ищите переменную в глобальной рабочей области.

varname

Имя переменной в другой рабочей области. Это - имя переменной, не указатель mxArray.

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

Указатель только для чтения на mxArray на успехе. Возвращает NULL в C (0 на Фортране) на отказе.

Описание

Вызовите mexGetVariablePtr, чтобы получить указатель только для чтения на заданную переменную, varname, в вашу рабочую область файла MEX. Эта команда полезна для исследования данных и характеристик mxArray. Если вы хотите изменить данные или характеристики, используйте mexGetVariable (наряду с mexPutVariable) вместо mexGetVariablePtr.

Если вы просто хотите исследовать данные или характеристики, mexGetVariablePtr предлагает наилучшее решение, потому что вызывающая сторона хочет передать только указатель на массив.

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

mexGetVariable

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

Документация MATLAB
Поддержка