# 3.18 `copy` -- 浅いコピーおよび深いコピー操作

このモジュールでは汎用の (浅い／深い) コピー操作を提供しています。

以下にインタフェースをまとめます:

    import copy

    x = copy.copy(y)        # make a shallow copy of y
    x = copy.deepcopy(y)    # make a deep copy of y

このモジュール固有のエラーに対しては、`copy.error` が送出されます。

浅い (shllow) コピーと深い (deep) コピーの違いが関係するのは、 複合オブジェクト (リストやクラスインスタンスのような他のオブジェクトを 含むオブジェクト) だけです:

- 浅いコピー (shallow copy) は新たな複合オブジェクトを作成し、 その後 (可能な限り) 元のオブジェクト中に見つかったオブジェクトに対する 参照 を挿入します。

- 深いコピー (deep copy) は新たな複合オブジェクトを作成し、 その後元のオブジェクト中に見つかったオブジェクトの コピー を挿入します。

深いコピー操作には、しばしば浅いコピー操作の時には存在しない 2 つの 問題がついてまわります:

- 再帰的なオブジェクト (直接、間接に関わらず、自分自身に対する参照 を持つ複合オブジェクト) は再帰ループを引き起こします。

- 深いコピーでは、何もかも をコピーするため、例えば複数の コピー間で共有されるべき管理データ構造までも、余分にコピー してしまいます。

`deepcopy()` 関数では、これらの問題を以下のようにして 回避しています:

- 現在のコピー過程ですでにコピーされたオブジェクトからなる、 ``メモ'' 辞書を 保持します; かつ

- ユーザ定義のクラスでコピー操作やコピーされる内容の集合を上書きできる ようにします。

現在のバージョンでは、モジュール、クラス、関数、メソッド、スタック追跡、 スタック構造、ファイル、ソケット、ウィンドウ、アレイ、その他これらに 類似の型をコピーしません。

クラスでは、pickle 化を制御するためのインタフェース: `__getinitargs__()`、 `__getstate__()`、 および `__setstate__()` と同じインタフェースをコピーの制御に使うことが できます。これらのメソッドに関する情報は `pickle` モジュールの記述を 参照してください。`copy` モジュールは pickle 用関数登録モジュール `copy_reg` を使いません。

クラス独自のコピー実装を定義するために、特殊メソッド `__copy__()` および `__deepcopy__()` を定義することができます。前者は 浅いコピー操作を実装するために使われます; 追加の引数はありません。 後者は深いコピー操作を実現するために呼び出されます; この関数には 単一の引数としてメモ辞書が渡されます。`__deepcopy__()` の実装で、内容のオブジェクトに対して深いコピーを生成する必要がある場合、 `deepcopy()` を呼び出し、最初の引数にそのオブジェクトを、 メモ辞書を二つ目の引数に与えなければなりません。

参考資料:

`pickle`モジュール:
  オブジェクト状態の取得と復元をサポートするために 使われる特殊メソッドについて議論されています。.