Struct OwnedReadSession 

pub struct OwnedReadSession<S: Store> { /* private fields */ }

An owned, root-bound read context suitable for long-lived native binding handles. Unlike ReadSession, this type owns both manager and tree state, so foreign-language adapters can reuse retained routing state across calls.

Stateful point reads are synchronized. High-concurrency callers should use one session per worker rather than sharing one session across all workers.

Implementations

impl<S: Store> OwnedReadSession<S>

pub fn get_with<R>( &self, key: &[u8], read: impl FnOnce(&[u8]) -> R, ) -> Result<Option<R>, Error>

Read a value without allocating it while retaining root and route state across calls.

pub fn get_lease(&self, key: &[u8]) -> Result<Option<OwnedValueLease>, Error>

Retain the packed leaf containing a value. This is intended for native adapters that expose a callback-scoped view and release it deterministically when the callback returns.

pub fn get_many(&self, keys: &[Vec<u8>]) -> Result<Vec<Option<Vec<u8>>>, Error>

Read keys in caller order while holding the session state once.

pub fn get_many_with<K, F>(&self, keys: &[K], visit: F) -> Result<(), Error>

where K: AsRef<[u8]>, F: for<'value> FnMut(usize, &[u8], Option<&'value [u8]>),

Visit batch point-read results in input order while sharing route work.

pub fn scan_range_until<B>( &self, start: &[u8], end: Option<&[u8]>, visit: impl for<'entry> FnMut(EntryRef<'entry>) -> ControlFlow<B>, ) -> Result<ScanOutcome<B>, Error>

Visit a half-open range. The owned session keeps the root warm; the traversal itself remains borrowed and callback-scoped.

pub fn scan_range_diff_until<B>( &self, other: &Self, start: &[u8], end: Option<&[u8]>, visit: impl for<'diff> FnMut(DiffRef<'diff>) -> ControlFlow<B>, ) -> Result<ScanOutcome<B>, Error>

Visit differences between two root-bound sessions without copying diff fields. Both sessions must come from the same manager/store identity.

pub fn scan_conflicts_until<B>( &self, left: &Self, right: &Self, visit: impl for<'conflict> FnMut(ConflictRef<'conflict>) -> ControlFlow<B>, ) -> Result<ScanOutcome<B>, Error>

Visit genuine three-way conflicts between compatible root-bound sessions. The receiver is the merge base.

pub fn scan_range_session( &self, start: &[u8], end: Option<&[u8]>, ) -> Result<OwnedRangeScanSession<S>, Error>

Open a retained forward traversal that seeks once and continues from the same native stack across pages.

pub fn tree(&self) -> &Tree

The immutable tree bound to this session.