Struct GcState 

pub struct GcState { /* private fields */ }

The process-wide object lists every interpreter’s collections walk.

Interpreter-owned policy and results live in GcInterpreterState; what is here is shared because the lists are: an object is untracked from default_dealloc, where no interpreter is in scope, so it has to be findable without one.

Implementations

impl GcState

pub const fn new() -> Self

pub fn get_count(&self) -> (usize, usize, usize)

Get counts for all generations. Tracked objects are shared, so these are process-wide even though the thresholds they are compared against are per interpreter.

pub unsafe fn track_object(&self, obj: NonNull<PyObject>, owner: u16)

Track a new object (add to gen0) as owned by owner. O(1) — intrusive linked list push_front, no hashing.

Safety

obj must be a valid pointer to a PyObject

pub unsafe fn untrack_object(&self, obj: NonNull<PyObject>)

Untrack an object (remove from GC lists). O(1) — intrusive linked list remove by node pointer.

Safety

obj must be a valid pointer to a PyObject that is currently tracked. The object’s memory must still be valid (pointers are read).

pub fn get_objects( &self, generation: Option<i32>, owner: u16, ) -> Vec<PyObjectRef>

Get the objects owner tracks (for gc.get_objects), plus the ones no interpreter owns. If generation is None, returns all such objects. If generation is Some(n), returns those in generation n only.

pub fn get_freeze_count(&self) -> usize

Get count of frozen objects

Trait Implementations

impl Default for GcState

fn default() -> Self

Returns the “default value” for a type.