Struct LockFreeVersion 

pub struct LockFreeVersion {
    pub storage: ValueStorage,
    pub txn_id: u64,
    pub commit_ts: AtomicU64,
    pub next: AtomicPtr<LockFreeVersion>,
}

Version of a key-value pair for lock-free access

Uses inline storage for small values to eliminate heap allocation and improve cache locality. Most database values (80%+) fit inline.

Fields

storage: ValueStorage

The value with optimized inline storage

txn_id: u64

Transaction that created this version

commit_ts: AtomicU64

Commit timestamp (0 = uncommitted)

next: AtomicPtr<LockFreeVersion>

Next version in chain (older)

Implementations

impl LockFreeVersion

pub fn new_from_slice(value: Option<&[u8]>, txn_id: u64) -> Self

Create a new uncommitted version with value slice (zero-copy for inline)

pub fn new(value: Option<Vec<u8>>, txn_id: u64) -> Self

Create a new uncommitted version (legacy API - accepts owned Vec)

pub fn get_value(&self) -> Option<&[u8]>

Get the value as bytes (zero-copy for inline values)

pub fn value_cloned(&self) -> Option<Vec<u8>>

Get the value as owned Vec (for compatibility)

Note: Prefer get_value() to avoid allocation

pub fn is_committed(&self) -> bool

Check if committed

pub fn get_commit_ts(&self) -> u64

Get commit timestamp

pub fn set_commit_ts(&self, ts: u64)

Set commit timestamp

pub fn is_inline(&self) -> bool

Check if value is stored inline (for diagnostics)

Trait Implementations

impl Debug for LockFreeVersion

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

Formats the value using the given formatter.