Exponenta Banner
exponenta event banner

mexGetVariablePtr (C и 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 в Фортране на провале.

Ограничения

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

См. также

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

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

Поддержка