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 на Фортране на отказе.

Ограничения

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

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

Представлено до R2006a
Для просмотра документации необходимо авторизоваться на сайте