Struct RoaringValue 

pub struct RoaringValue { /* private fields */ }

Value type for RoaringTreemap in partitioned tables.

This struct provides the bridge between the generic partitioned storage and roaring-specific value operations. It handles:

• Serialization/deserialization of RoaringTreemap
• Size queries for segment rolling decisions
• Version management for future migrations

Implementations

impl RoaringValue

pub fn new(bitmap: RoaringTreemap) -> Self

Creates a new RoaringValue from an existing bitmap.

pub fn empty() -> Self

Creates an empty RoaringValue.

pub fn bitmap(&self) -> &RoaringTreemap

Returns a reference to the underlying bitmap.

pub fn bitmap_mut(&mut self) -> &mut RoaringTreemap

Returns a mutable reference to the underlying bitmap.

pub fn into_bitmap(self) -> RoaringTreemap

Consumes the value and returns the underlying bitmap.

pub fn encode(&self) -> Result<Vec<u8>>

Encodes a RoaringTreemap into storage format.

Arguments

• bitmap - The roaring bitmap to encode

Returns

Encoded bytes ready for storage

pub fn encode_bitmap(bitmap: &RoaringTreemap) -> Result<Vec<u8>>

Encodes a RoaringTreemap into storage format.

Arguments

• bitmap - The roaring bitmap to encode

Returns

Encoded bytes ready for storage

pub fn decode(data: &[u8]) -> Result<Self>

Decodes storage bytes into a RoaringValue.

Arguments

• data - The encoded value bytes

Returns

Decoded RoaringValue

pub fn get_serialized_size(&self) -> Result<usize>

Gets the serialized size of a RoaringTreemap.

This size is used by the partition layer to determine when to roll segments based on the configured maximum segment size.

Arguments

• bitmap - The roaring bitmap to measure

Returns

Serialized size in bytes (including version prefix)

pub fn get_serialized_size_for(bitmap: &RoaringTreemap) -> Result<usize>

Gets the serialized size of a RoaringTreemap.

This size is used by the partition layer to determine when to roll segments based on the configured maximum segment size.

Arguments

• bitmap - The roaring bitmap to measure

Returns

Serialized size in bytes (including version prefix)

pub fn from_single(value: u64) -> Self

Creates a RoaringValue from a single value.

pub fn from_iter<I>(iter: I) -> Self

where I: IntoIterator<Item = u64>,

Creates a RoaringValue from an iterator of values.

pub fn len(&self) -> u64

Returns the number of members in the bitmap.

pub fn is_empty(&self) -> bool

Returns true if the bitmap is empty.

Trait Implementations

impl Clone for RoaringValue

fn clone(&self) -> RoaringValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RoaringValue

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

Formats the value using the given formatter.

impl Default for RoaringValue

fn default() -> Self

Returns the “default value” for a type.

impl From<RoaringTreemap> for RoaringValue

fn from(value: RoaringTreemap) -> Self

Converts to this type from the input type.

impl MergeableValue for RoaringValue

fn merge(existing: Option<Self>, incoming: Self) -> Self

Merge an incoming value with an existing value (if any).

impl PartialEq for RoaringValue

fn eq(&self, other: &RoaringValue) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl Value for RoaringValue

type SelfType<'a> = RoaringValue where Self: 'a

SelfType<'a> must be the same type as Self with all lifetimes replaced with ’a

type AsBytes<'a> = Vec<u8> where Self: 'a

fn fixed_width() -> Option<usize>

Width of a fixed type, or None for variable width

fn from_bytes<'a>(data: &'a [u8]) -> Self::SelfType<'a>

where Self: 'a,

Deserializes data Implementations may return a view over data, or an owned type

fn as_bytes<'a, 'b: 'a>(value: &'a Self::SelfType<'b>) -> Self::AsBytes<'a>

where Self: 'b,

Serialize the value to a slice

fn type_name() -> TypeName

Globally unique identifier for this type

impl StructuralPartialEq for RoaringValue