Struct GcRuntime 

pub struct GcRuntime { /* private fields */ }

QuickJS-style runtime heap: reference counting + three-phase cycle removal.

Implementations

impl GcRuntime

pub fn new() -> Self

pub fn malloc_state(&self) -> &MallocState

pub fn malloc_state_mut(&mut self) -> &mut MallocState

pub fn gc_threshold(&self) -> usize

pub fn set_gc_threshold(&mut self, threshold: usize)

threshold == usize::MAX disables automatic GC, matching JS_SetGCThreshold(rt, -1).

pub fn gc_phase(&self) -> GcPhase

pub fn gc_object_count(&self) -> usize

pub fn add_gc_object( &mut self, object: Box<dyn GcObject>, gc_obj_type: GcObjectType, ) -> GcId

Register a new GC object with ref_count = 1 on gc_obj_list. Matches QuickJS add_gc_object.

pub fn dup_gc(&mut self, id: GcId) -> GcId

Increment refcount. Matches QuickJS js_dup for GC objects.

pub fn free_gc(&mut self, id: GcId)

Decrement refcount and free when it reaches zero. Matches QuickJS JS_FreeValueRT for GC objects.

pub fn add_ref_counted<F>(&mut self, on_free: F) -> RefCountId

where F: FnOnce(&mut GcRuntime) + 'static,

Allocate a simple refcounted payload (strings, etc.). Not cycle-collected.

pub fn dup_ref_counted(&mut self, id: RefCountId) -> RefCountId

pub fn free_ref_counted(&mut self, id: RefCountId)

pub fn mark_gc_header(&mut self, id: GcId, mark_func: MarkFunc)

Mark a GC object header during traversal. Matches JS_MarkValue for object tags.

pub fn mark_children(&mut self, id: GcId, mark_func: MarkFunc)

Traverse children of a GC object. Matches QuickJS mark_children.

pub fn trigger_gc(&mut self, alloc_size: usize)

Maybe run GC when tracked malloc exceeds threshold. Matches js_trigger_gc.

pub fn run_gc(&mut self)

Run the three-phase cycle collector. Matches JS_RunGC.

pub fn is_live_object(&self, id: GcId) -> bool

Return false if the object has been freed during cycle collection. Matches JS_IsLiveObject.

pub fn ref_count(&self, id: GcId) -> i32

pub fn object_exists(&self, id: GcId) -> bool

pub fn object_downcast<T: GcObject>(&self, id: GcId) -> Option<&T>

pub fn object_downcast_mut<T: GcObject>(&mut self, id: GcId) -> Option<&mut T>

Trait Implementations

impl Default for GcRuntime

fn default() -> Self

Returns the “default value” for a type.