Struct ArchiveEntry 

pub struct ArchiveEntry<'a, const KEY_LEN: usize> { /* private fields */ }

Insertion entry for archive-backed PATCHes (V = () only).

Holds a thin pointer into an archive’s bytes plus a borrow of the Arc<dyn ArchiveOwner> that keeps those bytes alive. When inserted via PATCH::insert_archive, the entry’s key becomes a [Head::new_local_leaf] under a Branch whose owner matches; on owner mismatch the leaf is automatically reified into a heap- allocated Leaf<KEY_LEN, ()> so the result is owner-consistent.

The owner is borrowed (not owned) so the ingest hot loop pays zero atomic ref-count traffic per trible — the only clones happen lazily inside the receiving PATCH when a Branch actually adopts the owner. The caller (typically a chunked-archive decoder) keeps one Arc alive on the stack for the whole batch.

Only valid for V = () because archive bytes don’t carry a value field — the constructor’s type parameter enforces this.

Implementations

impl<'a, const KEY_LEN: usize> ArchiveEntry<'a, KEY_LEN>

pub unsafe fn new( ptr: NonNull<[u8; KEY_LEN]>, owner: &'a Arc<dyn ArchiveOwner>, ) -> Self

Creates an ArchiveEntry referencing a [u8; KEY_LEN] trible inside an archive’s bytes. Computes the siphash24 of the trible’s bytes eagerly so the 6 covering indexes can share it.

Safety

• ptr must remain valid for as long as owner is held.
• ptr must be 16-byte aligned (so [Head::new_local_leaf]’s tagged-pointer encoding has room for the LocalLeaf tag in the low 4 bits). Any [u8; 64] at an offset that’s a multiple of 16 from a 16-byte aligned base satisfies this.

pub fn owner(&self) -> &'a Arc<dyn ArchiveOwner>

Borrows the owner Arc without cloning.

Trait Implementations

impl<'a, const KEY_LEN: usize> Clone for ArchiveEntry<'a, KEY_LEN>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a, const KEY_LEN: usize> Copy for ArchiveEntry<'a, KEY_LEN>

impl<'a, const KEY_LEN: usize> Debug for ArchiveEntry<'a, KEY_LEN>

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

Formats the value using the given formatter.