# 약한 참조 객체

파이썬은 약한 참조를 1급 객체로 지원합니다. 약한 참조를 직접 구현하는 두 가지 구체적인 객체 형이 있습니다. 첫 번째는 간단한 참조 객체이며, 두 번째는 가능한 한 원래 객체의 프락시 역할을 합니다.

int PyWeakref_Check(PyObject *ob)

  ob가 참조 객체나 프락시 객체면 0이 아닌 값을 반환합니다. 이 함수는 항상 성공합니다.

int PyWeakref_CheckRef(PyObject *ob)

  ob가 참조 객체면 0이 아닌 값을 반환합니다. 이 함수는 항상 성공합니다.

int PyWeakref_CheckProxy(PyObject *ob)

  ob가 프락시 객체면 0이 아닌 값을 반환합니다. 이 함수는 항상 성공합니다.

PyObject *PyWeakref_NewRef(PyObject *ob, PyObject *callback)
  반환값: 새 참조. Part of the 안정 ABI.

  ob 객체에 대한 약한 참조 객체를 반환합니다. 이것은 항상 새로운 참조를 돌려주지만, 새로운 객체를 생성하는 것이 보장되지는 않습니다; 기존 참조 객체가 반환될 수 있습니다. 두 번째 매개 변수인 callback은 ob가 가비지 수집될 때 알림을 받는 콜러블 객체가 될 수 있습니다; 하나의 매개 변수를 받아들여야 하는데, 약한 참조 객체 자체입니다. callback은 `None` 이나 `NULL` 일 수도 있습니다. ob가 약하게 참조할 수 있는 객체가 아니거나, callback이 콜러블, `None` 또는 `NULL`이 아니면, `NULL`을 반환하고 `TypeError`를 발생시킵니다.

PyObject *PyWeakref_NewProxy(PyObject *ob, PyObject *callback)
  반환값: 새 참조. Part of the 안정 ABI.

  ob 객체에 대한 약한 참조 프락시 객체를 반환합니다. 이것은 항상 새로운 참조를 돌려주지만, 새로운 객체를 생성하는 것이 보장되지는 않습니다; 기존 프락시 객체가 반환될 수 있습니다. 두 번째 매개 변수인 callback은 ob가 가비지 수집될 때 알림을 받는 콜러블 객체가 될 수 있습니다; 하나의 매개 변수를 받아들여야 하는데, 약한 참조 객체 자체입니다. callback은 `None` 이나 `NULL` 일 수도 있습니다. ob가 약하게 참조할 수 있는 객체가 아니거나, callback이 콜러블, `None` 또는 `NULL`이 아니면, `NULL`을 반환하고 `TypeError`를 발생시킵니다.

int PyWeakref_GetRef(PyObject *ref, PyObject **pobj)
  Part of the 안정 ABI 버전 3.13 이후로.

  Get a strong reference to the referenced object from a weak reference, ref, into *pobj.

  - On success, set *pobj to a new strong reference to the referenced object and return 1.

  - If the reference is dead, set *pobj to `NULL` and return 0.

  - On error, raise an exception and return -1.

  Added in version 3.13.

PyObject *PyWeakref_GetObject(PyObject *ref)
  반환값: 빌린 참조. Part of the 안정 ABI.

  약한 참조(ref)로부터 참조된 객체에 대한 빌린 참조를 반환합니다. 참조가 더는 살아있지 않으면, `Py_None`을 반환합니다.

  참고

  이 함수는 참조된 객체에 대한 빌린 참조를 반환합니다. 이는 빌린 참조의 마지막 사용 전에 파괴될 수 없을 때를 제외하고, 객체에 대해 항상 `Py_INCREF()`를 호출해야 함을 뜻합니다.

  Deprecated since version 3.13, will be removed in version 3.15: 대신 `PyWeakref_GetRef()`를 사용하십시오.

PyObject *PyWeakref_GET_OBJECT(PyObject *ref)
  반환값: 빌린 참조.

  `PyWeakref_GetObject()`와 유사하지만, 에러 검사를 수행하지 않습니다.

  Deprecated since version 3.13, will be removed in version 3.15: 대신 `PyWeakref_GetRef()`를 사용하십시오.

void PyObject_ClearWeakRefs(PyObject *object)
  Part of the 안정 ABI.

  This function is called by the `tp_dealloc` handler to clear weak references.

  This iterates through the weak references for object and calls callbacks for those references which have one. It returns when all callbacks have been attempted.

void PyUnstable_Object_ClearWeakRefsNoCallbacks(PyObject *object)
  이것은 불안정 API. It may change without warning in minor releases.

  Clears the weakrefs for object without calling the callbacks.

  This function is called by the `tp_dealloc` handler for types with finalizers (i.e., `__del__()`). The handler for those objects first calls `PyObject_ClearWeakRefs()` to clear weakrefs and call their callbacks, then the finalizer, and finally this function to clear any weakrefs that may have been created by the finalizer.

  In most circumstances, it’s more appropriate to use `PyObject_ClearWeakRefs()` to clear weakrefs instead of this function.

  Added in version 3.13.