La libreria di riferimento di Python

Previous: 3.17.2 Esempio Up: 3. Servizi runtime Python Next: 3.19 marshal

---

3.18 copy -- Operazioni di copia superficiale e profonda

Questo modulo fornisce operazioni di copia generiche (superficiale e profonda).

Sommario interfaccia:

import copy

x = copy.copy(y)        # crea una copia superficiale di y
x = copy.deepcopy(y)    # crea una copia profonda di y

La differenza tra copia superficiale e profonda è rilevante solo per oggetti composti (oggetti che contengono altri oggetti, come liste o istanze di classe):

• Una copia superficiale costruisce un nuovo oggetto complesso e (nei limite del possibile) inserisce in esso i riferimenti agli oggetti trovati nell'originale.

• Una copia profonda costruisce un nuovo oggetto complesso e, in maniera ricorsiva, inserisce in esso le copie degli oggetti trovati nell'originale.

Con la copia profonda, possono spesso presentarsi due problemi che non si verificano con le operazioni di copia superficiale:

• Oggetti ricorsivi (oggetti complessi che, direttamente o indirettamente, contengono un riferimento a sé stessi) possono causare un ciclo ricorsivo.

• Poichè la copia profonda copia tutto, potrebbe copiare troppi oggetti, come ad esempio le strutture dati amministrativi, che potrebbero venire condivise tra le copie.

La funzione deepcopy() evita questi problemi attraverso le seguenti modalità:

• tenere un dizionario ''memo'' degli oggetti già copiati durante il corrente passaggio di copia ; e

• lasciare che le classi definite dall'utente sovrascrivano l'operazione di copia o l'insieme dei componenti copiati.

Questa versione non copia tipi come moduli, classi, funzioni, metodi, tracce dello stack, frame dello stack, file, socket, finestre, array o altri tipi simili.

Le classi possono usare la stessa interfaccia per controllare la copia che viene usata per il controllo di serializzazione. Vedete la descrizione del modulo pickle per informazioni su questi metodi. Il modulo copy non usa il modulo di registrazione copy_reg.

Nel caso di una classe che definisca la propria implementazione di copia, si possono utilizzare i metodi speciali __copy__() e __deepcopy__(). Il primo viene chiamato per implementare l'operazione di copia superficiale. Il secondo viene chiamato per implementare l'operazione di copia profonda; viene passato un argomento, il dizionario memo. Se l'implementazione di __deepcopy__() ha necessità di fare una copia profonda di un componente, dovrebbe chiamare la funzione deepcopy() con il componente come primo argomento e il dizionario memo come secondo argomento.

---

La libreria di riferimento di Python

Previous: 3.17.2 Esempio Up: 3. Servizi runtime Python Next: 3.19 marshal

---

Release 2.3.4, documentation updated on 21. maggio 2005.