Пожизненное управление объектами C++ в MATLAB

Если библиотека создает объект, затем, библиотека ответственна за выпуск памяти. Аналогично, если MATLAB^® создает объект, затем, MATLAB ответственен за выпуск памяти. Существуют ситуации, однако, где память, выделенная и пользовательской библиотекой и MATLAB, может быть объединена в один объект MATLAB. MATLAB позволяет вам управлять пожизненным управлением объектами путем определения 'ReleaseOnCall' и 'DeleteFcn' аргументы в файле определения библиотеки.

Передайте владение памяти библиотеке

MATLAB владеет памятью, которая выделяется путем вызова конструктора. Пользовательская библиотека не должна освобождать эту память. Чтобы изменить это поведение, установите 'ReleaseOnCall' аргумент в defineArgument (FunctionDefinition) или defineArgument (MethodDefinition).

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

void setInputObj(ObjClass *obj);

Если вы создаете аргумент в MATLAB, то MATLAB владеет памятью.

obj = clib.libname.ObjClass;

Если вы передаете obj к setInputObj, затем и MATLAB и setInputObj владейте памятью, которая небезопасна.

clib.libname.setInputObj(obj)

Чтобы передать владение памяти библиотеке, измените setInputObj определение в файле определения библиотеки.

%setInputObjDefinition = addFunction(libnameDefinition, ...
%    'setInputObj(ObjClass * obj)', ...
%defineArgument(setInputObjDefinition,'obj','clib.libname.ObjClass',<DIRECTION>,<SHAPE>);

Установите DIRECTION и SHAPE и добавьте 'ReleaseOnCall' аргумент.

defineArgument(setInputObjDefinition,'obj','clib.libname.ObjClass','input',1,'ReleaseOnCall',true);

Передайте владение памяти MATLAB

MATLAB не освобождает память выделенный библиотекой. Если функция возвращает указатель или ссылку на объект, можно передать владение памяти MATLAB с помощью 'DeleteFcn' аргумент в defineOutput (FunctionDefinition) или defineOutput (MethodDefinition) функции.

Если вы задаете библиотечную функцию для функции средства удаления, то эта функция не включена в интерфейс, и пользователи не могут вызвать функцию из MATLAB. Пользователь MATLAB вызывает MATLAB delete функция, которая вызывает функцию, заданную deleteFcn.

Предположим, что у вас есть функция членства objFree это освобождает память.

ObjClass *objCreate(int32 a, int32 b); 
void objFree(ObjClass *obj);

Использовать objFree когда MATLAB удалит объект, измените objCreate определение в файле определения библиотеки.

%defineOutput(objCreateDefinition,'RetVal','clib.lbiname.ObjClass,<SHAPE>);

Установите SHAPE и добавьте 'DeleteFcn' аргумент.

defineOutput(objCreateDefinition,'RetVal','clib.libname.ObjClass,1,'DeleteFcn','libname::objFree');

MATLAB delete вызовы функции libname::objFree.

myObj = clib.libname.objCreate(x,y)
delete(myObj);

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