Union Segment

union Segment<T> {
    children: ManuallyDrop<[Atomic<Segment<T>>; 1024]>,
    elements: ManuallyDrop<[Atomic<T>; 1024]>,
}

A fixed size array of atomic pointers to other Segment<T> or T.

Each segment is either an inner segment with pointers to other, children Segment<T> or an element segment with pointers to T. This is determined by the height of this segment in the main array, which one needs to track separately. For example, use the main array root’s tag.

Since destructing segments requires its height information, it is not recommended to implement Drop. Rather, implement and use the custom Segment::deallocate method that accounts for the height of the segment.

Fields

children: ManuallyDrop<[Atomic<Segment<T>>; 1024]>

elements: ManuallyDrop<[Atomic<T>; 1024]>

Implementations

impl<T> Segment<T>

fn new() -> Owned<Self>

Create a new segment filled with null pointers. It is up to the callee to whether to use this as an intermediate or an element segment.

unsafe fn deallocate(self, height: usize)

Deallocates a segment of height.

Safety

• self must actually have height height.
• There should be no other references to possible children segments.

Trait Implementations

impl<T> Debug for Segment<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.