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 предлагает наилучшее решение, потому что вызывающая сторона хочет передать только указатель на массив.

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

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

`workspace` — Имя рабочей области
`const char` | `character(*)`

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

`base`	Ищите переменную в базовом рабочем пространстве.
`caller`	Ищите переменную в рабочей области вызывающей стороны.
`global`	Ищите переменную в глобальной рабочей области.

`varname` — Имя переменной
`const char` | `character(*)`

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

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

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

`mxArray` — Указатель на mxArray
`const mxArray*` | `mwPointer` | `NULL`

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

Ограничения

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

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

mexGetVariable

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

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

Поддержка

Памятка переводчика

1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.

2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.

3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.

4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.

5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.

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