Exponenta Banner

mexGetVariablePtr (C and Fortran)

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

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

Синтаксис C

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

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

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

Описание

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

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

Входные параметры

расширить все

Имя рабочей области, которое вы хотите mexGetVariablePtr для поиска, заданный как const char* на C или character*(*) на Фортране. Возможные значения:

base

Поиск переменной в базовом рабочем пространстве.

caller

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

global

Поиск переменной в глобальной рабочей области.

Имя переменной в другой рабочей области, заданное как const char* на C или character*(*) на Фортране. Это имя переменной, а не mxArray указатель.

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

расширить все

Указатель на mxArray только для чтения после успеха, вернулся как const mxArray* на C или mwPointer на Фортране. Возвращает NULL на C или 0 в ФОРТРАН на отказ.

Ограничения

  • Если вы используете эту функцию в Simulink® S-функции, не храните результат plhs mxArray указатели в любом состоянии блока s-function, которое сохраняется после завершения MEX-функции. Выходы этой функции имеют временные возможности и автоматически уничтожаются в конце вызова MEX-функции.

См. также

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

Документация MATLAB

Поддержка