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

Базовые знания

Class destructor - метод с именем delete что MATLAB^® неявно вызывает перед уничтожением объекта класса handle. Кроме того, пользовательский код может вызывать delete явное уничтожение объекта.

Nondestructor - метод с именем delete который не соответствует синтаксическим требованиям допустимого деструктора. Поэтому MATLAB не вызывает этот метод неявно при уничтожении объектов указатель. Метод с именем delete в классе значений не является деструктором. Метод с именем delete в классе значений, который устанавливает HandleCompatible атрибут к true не является деструктором.

Жизненный цикл объекта

Атрибуты метода

Синтаксис метода Handle Class Destructor

MATLAB вызывает деструктор класса handle при уничтожении объектов класса. MATLAB распознает метод с именем delete как деструктор классов, только если вы задаете delete как обычный метод с соответствующим синтаксисом.

Чтобы быть допустимым деструктором классов, delete метод:

В сложение, delete метод не должен:

MATLAB не вызывает несоответствующее delete метод при уничтожении объектов класса. Несоответствующее delete метод может предотвратить уничтожение объекта путем затенения handle метод удаления классов.

A delete метод, заданный классом значений, который совместим с указателем, не является деструктором, даже если delete метод наследуется подклассом указателей. Для получения информации о совместимых с указатель классах смотрите Handle Compatible Classes.

Объявить delete как обычный метод:

methods
   function delete(obj)
      % obj is always scalar
   ...
   end
end

Указатель Объекта во время delete Выполнение метода

Вызов delete метод на объекте всегда приводит к уничтожению объекта. Объект уничтожается при вызове delete выполняется явным образом в коде MATLAB или при вызове MATLAB, поскольку объект больше не доступен ни из одной рабочей области. Однажды вызванный, delete метод не может прервать или предотвратить уничтожение объекта.

A delete метод может получить доступ к свойствам удаляемого объекта. MATLAB уничтожает эти свойства только после delete методы для класса объекта и все суперклассы завершают выполнение.

Если a delete метод создает новые переменные, которые содержат указатель на удаляемый объект, и эти указатели недопустимы. После delete метод концов выполнение, указатели на удаленный объект в любых переменных в любой рабочей области недопустимы.

The isvalid метод возвращает false для указателя объекта в delete метод, поскольку уничтожение объектов начинается при вызове метода.

MATLAB вызывает delete методы в обратном порядке конструкции. То есть MATLAB вызывает подкласс delete методы перед суперклассом delete методы.

Если суперкласс ожидает, что свойство будет управляться подклассами, то суперкласс не должен обращаться к этому свойству в своем delete способ. Например, если подкласс использует унаследованное абстрактное свойство для хранения указателя на объект, то подкласс должен уничтожить этот объект в его delete метод, но суперкласс не должен получать доступ к этому свойству в своем delete способ.

Поддержка уничтожения частично построенных объектов

Ошибки, возникающие при построении объекта, могут привести к вызову delete до полного создания объекта. Поэтому классы delete методы должны быть способны работать с частично построенными объектами.

Для примера, PartialObject классы delete метод определяет, является ли Data свойство пустое перед доступом к данным, содержащимся в этом свойстве. Если ошибка возникает при присвоении аргумента конструктора Name свойство, MATLAB передает частично созданный объект для удаления.

classdef PartialObject < handle
   properties
      % Restrict the Name property
      % to a cell array
      Name cell
      Data
   end
   methods
      function h = PartialObject(name)
         if nargin > 0
            h.Name = name;
            h.Data.a = rand(10,1);
         end
      end
      function delete(h)
         % Protect against accessing properties
         % of partially constructed objects
         if ~isempty(h.Data)
            t = h.Data.a;
            disp(t)
         else
            disp('Data is empty')
         end
      end
   end
end

Ошибка возникает, если вы вызываете конструктор с char вектор, вместо необходимого массива ячеек:

obj = PartialObject('Test')

MATLAB передает частично построенный объект в delete способ. Конструктор не установил значение Data свойство, поскольку ошибка произошла при установке Name свойство.

Data is empty
Error setting 'Name' property of 'PartialObject' class:
...

Когда определять метод деструктора

Использование delete метод для выполнения операций очистки перед уничтожением объекта MATLAB. MATLAB вызывает delete метод надежно, даже если выполнение прерывается с помощью Ctrl-c или ошибки.

Если ошибка возникает во время конструкции класса handle, MATLAB вызывает деструктор классов объекта вместе с деструкторами для любых объектов, содержащихся в свойствах и любых инициализированных базовых классах.

Например, предположим, что метод открывает файл для записи, и вы хотите закрыть файл в своем delete способ. The delete метод может вызвать fclose на идентификаторе файла, который объект хранит в своих FileID свойство:

function delete(obj)
   fclose(obj.FileID);
end 

Деструкторы в иерархиях классов

Если вы создаете иерархию классов, каждый класс может задать свою собственную delete способ. При уничтожении объекта MATLAB вызывает delete метод каждого класса в иерархии. Определение delete метод в handle подкласс не переопределяет handle классы delete способ. Подкласс delete методы увеличивают суперкласс delete методы.

Жизненный цикл объекта

MATLAB вызывает delete метод, когда жизненный цикл объекта заканчивается. Жизненный цикл объекта заканчивается, когда объект:

classdef myClass < supclass1 & supclass2

Ограничьте доступ к методу удаления объектов

Уничтожить указатель объектов путем явного вызова delete на объекте:

delete(obj)

Класс может предотвратить явное уничтожение объекта путем установки его delete метод Access атрибут к private. Однако метод класса может вызвать private delete способ.

Если класс delete метод Access атрибут protected, только методы класса и подклассов могут явно удалять объекты этого класса.

Однако, когда жизненный цикл объекта заканчивается, MATLAB вызывает delete объекта метод при уничтожении объекта независимо от Access метода атрибут.

Неразрушающие методы удаления

Класс может реализовать метод с именем delete недопустимый деструктор классов. MATLAB не вызывает этот метод неявно при уничтожении объекта. В этом случае delete ведет себя как обычный метод.

Для примера, если суперкласс реализует Sealed метод с именем delete не является допустимым деструктором, MATLAB не позволяет подклассам переопределять этот метод.

A delete метод, заданный классом значений, не может быть деструктором классов.

Внешние ссылки на объекты MATLAB

MATLAB не управляет жизненными циклами объектов, которые включают внешние языки, которые выполняют управление собственным жизненным циклом объектов (он же, набор мусора). MATLAB не может обнаружить, когда безопасно уничтожать объекты, используемые в циклических ссылках, поскольку внешнее окружение не уведомляет MATLAB о том, когда внешняя ссылка была уничтожена.

Если вы не можете избежать внешних ссылок на объекты MATLAB, явно нарушите циклическую ссылку, уничтожив объекты в MATLAB.

В следующем разделе описывается, как управлять этой ситуацией при использовании Java^® объекты, которые ссылаются на объекты MATLAB.

classdef CallbackWithJava < handle
   methods
      function obj = CallbackWithJava
         jo = com.mathworks.jmi.Callback;
         set(jo,'DelayedCallback',@obj.cbFunc); % Assign method as callback
         jo.postCallback
      end
      function cbFunc(obj,varargin)
         c = class(obj);
         disp(['Java object callback on class ',c])
      end
      function delete(obj)
         c = class(obj);
         disp(['ML object destructor called for class ',c])
      end
   end
end

function testDestructor
   cwj = CallbackWithJava
   ...
end

testDestructor

cwj = 

  CallbackWithJava with no properties.

Java object callback on class CallbackWithJava

clear classes

Warning: Objects of 'CallbackWithJava' class exist.  Cannot clear this class or
any of its superclasses. 

function testDestructor
   cwj = CallbackWithJava
   ...
   delete(cwj)
end