gc_api 0.5.0

Generic abstractions for a multithreaded garbage collector
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

use crate::{Alloc, Gc};

pub mod roots;
mod trace_impls;

pub trait TracingAllocator {
    type Tracer<'a>: 'a + Tracer<'a, Self>;
}

/// A simple and versatile Trace trait modeled after `std::hash::Hash`.
pub trait Trace<A: TracingAllocator> {
    fn trace(&self, tracer: &mut A::Tracer<'_>);

    /// Honestly, I'm a little unsure of if this is necessary or not. However, `std::hash::Hash` has
    /// it so I will trust in their design logic.
    fn trace_slice(data: &[Self], tracer: &mut A::Tracer<'_>)
    where
        Self: Sized,
    {
        for item in data {
            item.trace(tracer);
        }
    }
}

/// Not sure what I want this to be, but I thought I might as well leave it as a stub to make
/// its usage more explicit.
pub trait Tracer<'a, A: ?Sized>: Sized
where
    A: TracingAllocator<Tracer<'a> = Self>,
{
    fn trace_obj<T: ?Sized + Trace<A>>(&mut self, obj: &Gc<T, A>)
    where
        A: Alloc<T>;
}