Skip to main content

PinnableSlice

Enum PinnableSlice 

Source
pub enum PinnableSlice {
    Pinned {
        _block: Block,
        value: Slice,
    },
    Owned(UserValue),
}
Expand description

A value reference that may share the decompressed block buffer.

Use PinnableSlice::as_ref to access the raw bytes regardless of variant.

§Lifetime

The Pinned variant holds a [Block] clone whose data field is a refcounted Slice. As long as the PinnableSlice is alive, the decompressed block buffer remains valid. Dropping it releases the reference count on the underlying ByteView allocation.

Variants§

§

Pinned

Value sharing the decompressed block buffer — zero copy.

The [Block] keeps the decompressed data alive via refcounted Slice / ByteView. value is a sub-slice created via Slice::slice, sharing the same backing allocation.

Fields

§_block: Block

Keeps the decompressed block buffer alive via refcount.

§value: Slice

Zero-copy sub-slice into the block’s decompressed data.

§

Owned(UserValue)

Value owned independently (memtable, blob, merge result).

Implementations§

Source§

impl PinnableSlice

Source

pub fn pinned(block: Block, value: Slice) -> Self

Creates a pinned value sharing the decompressed block buffer.

Source

pub fn owned(value: UserValue) -> Self

Creates an owned value (not sharing any block buffer).

Source

pub fn is_pinned(&self) -> bool

Returns true if this value shares the decompressed block buffer.

Source

pub fn value(&self) -> &[u8]

Returns the raw value bytes.

Source

pub fn len(&self) -> usize

Returns the length of the value in bytes.

Source

pub fn is_empty(&self) -> bool

Returns true if the value is empty.

Source

pub fn into_value(self) -> UserValue

Converts this PinnableSlice into an owned UserValue.

For the Pinned variant, the Block is dropped but the returned Slice still shares the same ByteView backing allocation. For the Owned variant, the value is returned directly.

Trait Implementations§

Source§

impl AsRef<[u8]> for PinnableSlice

Source§

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.
Source§

impl Clone for PinnableSlice

Source§

fn clone(&self) -> PinnableSlice

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for PinnableSlice

Source§

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

Formats the value using the given formatter. Read more
Source§

impl From<PinnableSlice> for UserValue

Source§

fn from(ps: PinnableSlice) -> Self

Converts to this type from the input type.
Source§

impl PartialEq<&[u8]> for PinnableSlice

Source§

fn eq(&self, other: &&[u8]) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl PartialEq<[u8]> for PinnableSlice

Source§

fn eq(&self, other: &[u8]) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.