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

Копирование метода для Классов Handle

Копирование переменной указателя приводит к другой переменной указателя, которая относится к тому же объекту. Можно добавить функциональность копии к классу Handle путем разделения на подклассы matlab.mixin.Copyable. Наследованный метод copy позволяет вам сделать мелкие копии объектов класса. Класс CopyObj показывает поведение операций копии.

classdef CopyObj < matlab.mixin.Copyable
   properties
      Prop
   end
end

Создайте объект класса CopyObj и присвойте указатель объекта line к свойству Prop.

a = CopyObj;
a.Prop = line;

Скопируйте объект.

b = copy(a);

Подтвердите, что переменные указателя a и b относятся к различным объектам.

a == b

ans =

  logical

   0

Однако объект line, упомянутый a.Prop, не был скопирован. Указатель, содержавшийся в a.Prop, называет тот же объект указателем, содержавшимся в b.Prop.

a.Prop == b.Prop

ans =

  logical

   1

Для более подробной информации о поведении операции копии смотрите matlab.mixin.Copyable.copy копия.

Настройка операции копирования

Настройте поведение копии объекта указателя путем получения класса от matlab.mixin.Copyable. Класс matlab.mixin.Copyable является абстрактным базовым классом, который выводит от класса Handle. matlab.mixin.Copyable обеспечивает шаблон для настройки объектных операций копии путем определения:

Метод copy matlab.mixin.Copyable, вызывает метод copyElement. Ваш подкласс настраивает операцию копии путем определения ее собственной версии copyElement.

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

Чтобы реализовать различное поведение копии для различных свойств, замените copyElement. Например, метод copyElement класса SpecializedCopy:

classdef SpecializedCopy < matlab.mixin.Copyable
   properties
      Prop1
      Prop2 = datestr(now)
   end
   methods(Access = protected)
      function cp = copyElement(obj)
         cp = SpecializedCopy;
         cp.Prop1 = obj.Prop1;
         cp.Prop2 = datestr(now);
      end
   end
end

Создайте объект класса и присвойте значение Prop1:

a  = SpecializedCopy;
a.Prop1 = 7

a = 

  SpecializedCopy with properties:

    Prop1: 7
    Prop2: '17-Feb-2015 17:51:23'

Используйте наследованный метод copy, чтобы создать копию a:

b = copy(a)

b = 

  SpecializedCopy with properties:

    Prop1: 7
    Prop2: '17-Feb-2015 17:51:58'

Копия (объект b) имеет то же значение для Prop1, но подкласс метод copyElement присвоил новое значение Prop2. Заметьте различную метку времени.

Copy Properties, которые содержат указатели

Копирование объекта также копирует значения свойств объектов. Свойства объектов могут содержать другие объекты, включая объекты указателя. Если вы просто копируете значение свойства, которое содержит объект указателя, вы на самом деле копируете указатель, не сам объект. Поэтому ваша копия ссылается на тот же объект как исходный объект. Классы, которые выводят от класса matlab.mixin.Copyable, могут настроить способ, которым метод копии копирует объекты класса.

a = HandleCopy;
a.Prop1 = 7;
a.Prop2 = ColorProp;

b = copy(a);

a.Prop2.Color = 'red';
b.Prop2.Color

ans =

blue

classdef HandleCopy < matlab.mixin.Copyable
   properties
      Prop1 % Shallow copy
      Prop2 % Handle copy
   end
   methods (Access = protected)
      function cp = copyElement(obj)
         % Shallow copy object
         cp = copyElement@matlab.mixin.Copyable(obj);
         % Get handle from Prop2
         hobj = obj.Prop2;
         % Create default object
         new_hobj = eval(class(hobj));
         % Add public property values from orig object
         HandleCopy.propValues(new_hobj,hobj);
         % Assign the new object to property
         cp.Prop2  = new_hobj;
      end
   end
   methods (Static)
      function propValues(newObj,orgObj)
         pl = properties(orgObj);
         for k = 1:length(pl)
            if isprop(newObj,pl{k})
               newObj.(pl{k}) = orgObj.(pl{k});
            end
         end
      end
   end
end

classdef ColorProp < handle
   properties
      Color = 'blue';
   end
end

Exclude Properties из копии

Используйте атрибут свойства NonCopyable, чтобы указать, что вы не хотите, чтобы операция копии скопировала конкретное значение свойства. По умолчанию NonCopyable является false, указывая, что значение свойства copyable. Можно установить NonCopyable на true только на свойствах классов Handle.

Для классов, которые выводят от matlab.mixin.Copyable, реализация по умолчанию copyElement соблюдает атрибут NonCopyable. Поэтому, если свойство имеет свой набор атрибута NonCopyable к true, то copyElement не копирует значение того свойства. Если вы заменяете copyElement в своем подклассе, можно выбрать, как использовать атрибут NonCopyable.

properties (NonCopyable)
   Prop1
end

classdef CopiedClass < matlab.mixin.Copyable
   properties (NonCopyable)
      Prop1
      Prop2 = datestr(now) % Assign current time
   end
end

a = CopiedClass;
a.Prop1 = 7

a = 

  CopiedClass with properties:

    Prop1: 7
    Prop2: '17-Feb-2015 15:19:34'

b = copy(a)

b = 

  CopiedClass with properties:

    Prop1: []
    Prop2: '17-Feb-2015 15:19:34'

obj = MyDynamicClass;
p = addprop(obj,'DynoProp');
p.NonCopyable = false;
obj2 = copy(obj);