Mar 14, 2023 · Feb 8, 2023 · Feb 18, 2023 · Feb 18, 2023 · Feb 20, 2023 · Feb 23, 2023
diff --git a/Doc/c-api/gcsupport.rst b/Doc/c-api/gcsupport.rst
   Returns the current state, 0 for disabled and 1 for enabled.

   .. versionadded:: 3.10


 Querying Garbage Collector State
 --------------------------------

 The C-API provides the following inerface for querying information about
 the garbage collector.

 .. c:function:: void PyUnstable_GC_VisitObjects(gcvisitobjects_t callback, void *arg)

   Run supplied callback on all live GC-capable objects.

   .. warning::
      If new objects are (de)allocated by the callback it is undefined if they
      will be visited.

   .. warning::
      Garbage collection is disabled during operation. Explicitly running a collection
      in the callback may lead to undefined behaviour e.g. visiting the same objects
      multiple times or not at all.

   .. versionadded:: 3.12

 .. c:type:: int (*gcvisitobjects_t)(PyObject *object, void *arg)

   Type of the visitor function to be passed to :c:func:`PyUnstable_GC_VisitObjects`.
   ``arg`` is the same as passed to ``PyUnstable_GC_VisitObjects``. Returning ``0``
   allows iteration to continue, returning ``1`` stops further iteration. Returning any
   other value has undefined behavior.

   .. versionadded:: 3.12


diff --git a/Misc/NEWS.d/next/C API/2023-02-18-00-55-14.gh-issue-102013.83mrtI.rst b/Misc/NEWS.d/next/C API/2023-02-18-00-55-14.gh-issue-102013.83mrtI.rst
 Add a new C-API function for iterating over GC'able objects using a callback: ``PyGC_VisitObjects``.
 Add a new(unstable)C-API function for iterating over GC'able objects using a callback: ``PyUnstable_VisitObjects``.
diff --git a/Modules/gcmodule.c b/Modules/gcmodule.c
            }
        }
    }
 done:;
 done:
    gcstate->enabled = origenstate;
 }
Original file line number	Diff line number	Diff line change
Expand Up		@@ -228,3 +228,36 @@ garbage collection runs.
		Returns the current state, 0 for disabled and 1 for enabled.

		.. versionadded:: 3.10


		Querying Garbage Collector State
		--------------------------------

		The C-API provides the following inerface for querying information about
jbower-fb marked this conversation as resolved. Show resolvedHide resolved
		the garbage collector.

		.. c:function:: void PyUnstable_GC_VisitObjects(gcvisitobjects_t callback, void *arg)

		Run supplied callback on all live GC-capable objects.
jbower-fb marked this conversation as resolved. Show resolvedHide resolved

		.. warning::
		If new objects are (de)allocated by the callback it is undefined if they
		will be visited.

		.. warning::
		Garbage collection is disabled during operation. Explicitly running a collection
		in the callback may lead to undefined behaviour e.g. visiting the same objects
		multiple times or not at all.
jbower-fb marked this conversation as resolved. Show resolvedHide resolved

		.. versionadded:: 3.12

		.. c:type:: int (gcvisitobjects_t)(PyObject object, void *arg)

		Type of the visitor function to be passed to :c:func:`PyUnstable_GC_VisitObjects`.
		``arg`` is the same as passed to ``PyUnstable_GC_VisitObjects``. Returning ``0``
		allows iteration to continue, returning ``1`` stops further iteration. Returning any
		other value has undefined behavior.
jbower-fb marked this conversation as resolved. Show resolvedHide resolved

		.. versionadded:: 3.12
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		Add a new C-API function for iterating over GC'able objects using a callback: ``PyGC_VisitObjects``.
		Add a new(unstable)C-API function for iterating over GC'able objects using a callback: ``PyUnstable_VisitObjects``.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -2422,6 +2422,6 @@ PyUnstable_GC_VisitObjects(gcvisitobjects_t callback, void *arg)
		}
		}
		}
		done:;
		done:
		gcstate->enabled = origenstate;
		}