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

Элементарные знания

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

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

Объектный жизненный цикл

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

Синтаксис метода деструктора класса Handle

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

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

Кроме того, delete метод не должен:

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

delete метод, заданный классом значения, который является совместимым указателем, не является деструктором, даже если delete метод наследован подклассом указателя. Для получения информации об указателе совместимые классы смотрите Указатель Совместимые Классы.

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

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

Объект указателя во время delete Осуществление метода

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

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

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

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 метод. 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 не позволяет подклассам заменять этот метод.

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