Esta documentação é de uma versão antiga do Python que não é mais atualizada. Você deveria atualizar e ler a documentação do Python para versão estável atual.

# `copy` — Operações de cópia profunda e cópia sombra

Código Fonte: Lib/copy.py

As instruções de atribuição no Python não copiam objetos, elas criam ligações entre um destino e um objeto. Para coleções que são mutáveis ​​ou contêm itens mutáveis, às vezes é necessária uma cópia para que seja possível alterar uma cópia sem alterar a outra. Este módulo fornece operações genéricas de cópia profunda e rasa (explicadas abaixo).

Sumário da Interface:

`copy.``copy`(x)

  Devolve uma cópia rasa de x.

`copy.``deepcopy`(x[, memo])

  Retorna uma cópia profunda de x.

exception `copy.``error`

  Levantada para erros específicos do módulo.

A diferença entre cópia profunda e rasa é relevante apenas para objetos compostos (objetos que contêm outros objetos, como listas ou instâncias de classe):

- Uma cópia rasa constrói um novo objeto composto e então (na medida do possível) insere nele referências aos objetos encontrados no original.

- Uma cópia profunda constrói um novo objeto composto e então, recursivamente, insere nele cópias dos objetos encontrados no original.

Frequentemente, existem dois problemas com operações de cópia profunda que não existem com operações de cópia rasa:

- Objetos recursivos (objetos compostos que, direta ou indiretamente, contêm uma referência a si mesmos) podem causar um laço recursivo.

- Como a cópia profunda copia tudo, ela pode copiar muito, como dados que devem ser compartilhados entre as cópias.

A função `deepcopy()` evita esses problemas:

- mantendo um dicionário `memo` de objetos já copiados durante a passagem de cópia atual; e

- permitindo que as classes definidas pelo usuário substituam a operação de cópia ou o conjunto de componentes copiados.

Este módulo não copia tipos como módulo, método, rastreamento de pilha, quadro de pilha, arquivo, soquete, janela, matriz ou outros tipos semelhantes. Ele “copia” funções e classes (rasas e profundas), devolvendo o objeto original inalterado; isso é compatível com a maneira que estes itens são tratados pelo módulo `pickle`.

Cópias rasas de dicionários podem ser feitas usando `dict.copy()`, e de listas atribuindo uma fatia de toda a lista, por exemplo, `lista_copiada = lista_original[:]`.

As classes podem usar as mesmas interfaces para controlar a cópia que usam para controlar o pickling. Veja a descrição do módulo `pickle` para informações sobre esses métodos. Na verdade, o módulo `copy` usa as funções pickle registradas do módulo `copyreg`.

Para que uma classe defina sua própria implementação de cópia, ela pode definir métodos especiais `__copy__()` e `__deepcopy__()`. O primeiro é chamado para implementar a operação de cópia rasa; nenhum argumento adicional é passado. O último é chamado para implementar a operação de cópia profunda; é passado um argumento, o dicionário `memo`. Se a implementação de `__deepcopy__()` precisa fazer uma cópia profunda de um componente, ela deve chamar a função `deepcopy()` com o componente como primeiro argumento e o dicionário de memorando como segundo argumento.

Ver também

Módulo `pickle`

  Discussão dos métodos especiais usados ​​para dar suporte à recuperação e restauração do estado do objeto.