copy – операции поверхностного и глубокого копирования¶copy – Shallow and deep copy operations

Исходный код: Lib/copy.py

Операторы присваивания в Python не копируют объекты, они создают привязки между целью и объектом. Для изменяемых коллекций или коллекций, содержащих изменяемые элементы, иногда требуется копия, чтобы можно было изменить одну копию, не меняя другую. Этот модуль предоставляет общие операции поверхностного и глубокого копирования (объяснены ниже).

Краткое описание интерфейса:

copy.copy(obj)¶

Возвращает поверхностную копию obj.

copy.deepcopy(obj[, memo])¶

Возвращает глубокую копию obj.

copy.replace(obj, /, **changes)¶

Создаёт новый объект того же типа, что и obj, заменяя поля значениями из changes.

Добавлено в версии 3.13.

exception copy.Error¶

Возбуждается при ошибках, специфичных для модуля.

Разница между поверхностным и глубоким копированием актуальна только для составных объектов (объектов, содержащих другие объекты, например, списки или экземпляры классов):

• Поверхностная копия создаёт новый составной объект, а затем (насколько это возможно) вставляет в него ссылки на объекты, найденные в оригинале.

• Глубокая копия создаёт новый составной объект, а затем рекурсивно вставляет в него копии объектов из оригинала.

Две проблемы, часто возникающие при глубоком копировании, которых нет при поверхностном:

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

• Поскольку глубокое копирование копирует всё, оно может скопировать лишнее, например, данные, предназначенные для совместного использования между копиями.

Функция deepcopy() позволяет избежать этих проблем за счёт:

• ведения словаря memo уже скопированных объектов в текущем проходе копирования; и

• предоставления пользовательским классам возможности переопределить операцию копирования или набор копируемых компонентов.

Этот модуль не копирует такие типы, как модуль, метод, трассировка стека, кадр стека, файл, сокет, окно или любые подобные типы. Он «копирует» функции и классы (поверхностно и глубоко), возвращая исходный объект без изменений; это совместимо с тем, как эти типы обрабатываются модулем pickle.

Поверхностные копии многих коллекций можно получить с помощью соответствующего метода copy() (например, list.copy(), dict.copy() или set.copy()), а последовательностей (например, списков или bytearray) – с помощью среза всей последовательности (sequence[:]). Однако эти методы и срез могут создать экземпляр базового типа при копировании экземпляра подкласса, тогда как copy.copy() обычно возвращает экземпляр того же типа.

Классы могут использовать те же интерфейсы для управления копированием, что и для управления сериализацией (pickling). См. описание модуля pickle для получения информации об этих методах. Фактически, модуль copy использует зарегистрированные функции pickle из модуля copyreg.

Чтобы класс мог определить собственную реализацию копирования, он может определить специальные методы __copy__() и __deepcopy__().

object.__copy__(self)¶

Вызывается для реализации операции поверхностного копирования; дополнительные аргументы не передаются.

object.__deepcopy__(self, memo)¶

Вызывается для реализации операции глубокого копирования; ему передаётся один аргумент – словарь memo. Если реализация __deepcopy__ должна сделать глубокую копию компонента, ей следует вызвать функцию deepcopy(), передав компонент первым аргументом и словарь memo вторым. Словарь memo следует рассматривать как непрозрачный объект.

Функция copy.replace() более ограничена, чем copy() и deepcopy(), и поддерживает только именованные кортежи, созданные namedtuple(), dataclasses и другими классами, которые определяют метод __replace__().

object.__replace__(self, /, **changes)¶

Этот метод должен создать новый объект того же типа, заменяя поля значениями из изменений.

Добавлено в версии 3.13.