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