pub struct CandidateCodec { /* private fields */ }Expand description
A private lifetime-bound transport for one source’s ordered candidate rows.
Implementations§
Source§impl CandidateCodec
impl CandidateCodec
Sourcepub fn new(heap: &Heap) -> Result<Self, Error>
pub fn new(heap: &Heap) -> Result<Self, Error>
Retains the source’s live Store and issues a nonreused lifetime token.
§Errors
The process lifetime token space is exhausted.
Sourcepub fn encode(
&self,
heap: &mut Heap,
roots: &[Handle],
limit: usize,
) -> Result<Vec<u8>, Error>
pub fn encode( &self, heap: &mut Heap, roots: &[Handle], limit: usize, ) -> Result<Vec<u8>, Error>
Copies closed local roots into an owned child-first DAG without promotion.
Existing persistent subtrees remain checked references to this live Store. Byte limits bound traversal/deduplication scratch. No new evaluation, normalization demand or persistent origin allocation is performed.
§Errors
A foreign/stale/lazy value, legacy history, nesting/byte limit or allocation.
Sourcepub fn decode(
&mut self,
heap: &mut Heap,
bytes: &[u8],
limit: usize,
) -> Result<Vec<Handle>, Error>
pub fn decode( &mut self, heap: &mut Heap, bytes: &[u8], limit: usize, ) -> Result<Vec<Handle>, Error>
Imports one unchanged record only when ordered commit consumes it.
Shared children retain their aliases. Legacy constructor origins are refused.
§Errors
Invalid format, owner, shape, reference, allocation or construction origin.
Sourcepub const fn origin_index_bytes(&self) -> usize
pub const fn origin_index_bytes(&self) -> usize
Retained legacy report metric. Canonical candidates allocate no origins.