Main Content

copy

Class: matlab.mixin.Copyable
Package: matlab.mixin

Copy array of handle objects

Syntax

B = copy(A)

Description

B = copy(A) copies each element in the array of handles A to the new array of handles B.

The copy method performs a copy according to the following rules:

  • The copy method does not copy Dependent properties

  • MATLAB® does not call the copy method recursively on any handles contained in property values

  • MATLAB does not call the class constructor or property set methods during the copy operation.

  • B has the same number of elements and same size as A.

  • B is the same class as A.

  • If A is empty, B is also empty.

  • If A is heterogeneous, B is also heterogeneous.

  • If A contains deleted handle objects, copy creates deleted handles of the same class in B.

  • Dynamic properties and listeners associated with objects in A are not copied to objects in B.

  • You can call copy inside your class delete method.

Input Arguments

A

Handle object array

Output Arguments

B

Handle object array containing copies of the objects in A.

Attributes

Sealedtrue

To learn about attributes of methods, see Method Attributes.

Version History

Introduced in R2011a