약한 참조 객체
**************

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

int PyWeakref_Check(PyObject *ob)

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

int PyWeakref_CheckRef(PyObject *ob)

   Return non-zero if *ob* is a reference object or a subclass of the
   reference type.  This function always succeeds.

int PyWeakref_CheckRefExact(PyObject *ob)

   Return non-zero if *ob* is a reference object, but not a subclass
   of the reference type.  This function always succeeds.

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"를 발생시킵니다.

   더 보기:

     "PyType_SUPPORTS_WEAKREFS()" for checking if *ob* is weakly
     referenceable.

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

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

   더 보기:

     "PyType_SUPPORTS_WEAKREFS()" for checking if *ob* is weakly
     referenceable.

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()"를 사용하십시오.

int PyWeakref_IsDead(PyObject *ref)

   Test if the weak reference *ref* is dead. Returns 1 if the
   reference is dead, 0 if it is alive, and -1 with an error set if
   *ref* is not a weak reference object.

   Added in version 3.14.

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.
