Skip to main content

OnIoDupSuber

Struct OnIoDupSuber 

Source
pub struct OnIoDupSuber<C: ValueCodec = Utf8Codec> {
    pub on_base: OnSuberBase<C>,
    pub io_dup_suber: IoDupSuber<C>,
}

Fields§

§on_base: OnSuberBase<C>§io_dup_suber: IoDupSuber<C>

Implementations§

Source§

impl<C: ValueCodec> OnIoDupSuber<C>

Source

pub fn new( db: Arc<LMDBer>, subkey: &str, sep: Option<u8>, verify: bool, ) -> Result<Self, SuberError>

Source

pub fn add_on<K: AsRef<[u8]>, V: ?Sized + Clone + Into<Vec<u8>>>( &self, keys: &[K], on: u32, val: &V, ) -> Result<bool, SuberError>

Adds val idempotently at key made from keys in insertion order using hidden ordinal proem. Idempotently means do not add val that is already in dup vals at key. Does not overwrite.

Source

pub fn append_on<K: AsRef<[u8]>, V: ?Sized + Clone + Into<Vec<u8>>>( &self, keys: &[K], val: &V, ) -> Result<u64, SuberError>

Appends a value and returns the ordinal number of the newly appended val

Source

pub fn get_on<K: AsRef<[u8]>, R: TryFrom<Vec<u8>>>( &self, keys: &[K], on: u32, ) -> Result<Vec<R>, SuberError>
where <R as TryFrom<Vec<u8>>>::Error: Debug,

Gets dup vals list at key made from keys

Source

pub fn rem_on<K: AsRef<[u8]>, V: ?Sized + Clone + Into<Vec<u8>>>( &self, keys: &[K], on: u32, val: Option<&V>, ) -> Result<bool, SuberError>

Removes entry at key made from keys and dup val that matches val if any, notwithstanding hidden ordinal proem. Otherwise deletes all dup values at key if any.

Source

pub fn get_on_iter<K: AsRef<[u8]>, R: TryFrom<Vec<u8>> + 'static>( &self, keys: &[K], on: u32, ) -> Result<Box<dyn Iterator<Item = Result<R, SuberError>> + '_>, SuberError>
where <R as TryFrom<Vec<u8>>>::Error: Debug, SuberError: From<<R as TryFrom<Vec<u8>>>::Error>,

Returns an iterator that yields deserialized values from the database

Source

pub fn get_on_item_iter<K: AsRef<[u8]>, R: TryFrom<Vec<u8>> + 'static>( &self, keys: &[K], on: u32, ) -> Result<Box<dyn Iterator<Item = Result<(Vec<Vec<u8>>, u64, R), SuberError>> + '_>, SuberError>
where <R as TryFrom<Vec<u8>>>::Error: Debug, SuberError: From<<R as TryFrom<Vec<u8>>>::Error>,

Returns an iterator that yields triples of (keys, on, val)

Source

pub fn get_on_last_iter<K: AsRef<[u8]>, R: TryFrom<Vec<u8>> + 'static>( &self, keys: &[K], on: u32, ) -> Result<Box<dyn Iterator<Item = Result<R, SuberError>> + '_>, SuberError>
where <R as TryFrom<Vec<u8>>>::Error: Debug, SuberError: From<<R as TryFrom<Vec<u8>>>::Error>,

Returns an iterator that yields the last duplicate value for each key

Source

pub fn get_on_last_item_iter<K: AsRef<[u8]>, R: TryFrom<Vec<u8>> + 'static>( &self, keys: &[K], on: u32, ) -> Result<Box<dyn Iterator<Item = Result<(Vec<Vec<u8>>, u64, R), SuberError>> + '_>, SuberError>
where <R as TryFrom<Vec<u8>>>::Error: Debug, SuberError: From<<R as TryFrom<Vec<u8>>>::Error>,

Returns an iterator that yields triples of (keys, on, val) for the last duplicate values

Source

pub fn get_on_back_iter<K: AsRef<[u8]>, R: TryFrom<Vec<u8>> + 'static>( &self, keys: &[K], on: u32, ) -> Result<Box<dyn Iterator<Item = Result<R, SuberError>> + '_>, SuberError>
where <R as TryFrom<Vec<u8>>>::Error: Debug, SuberError: From<<R as TryFrom<Vec<u8>>>::Error>,

Returns an iterator that yields deserialized values from the database in reverse order

Source

pub fn get_on_item_back_iter<K: AsRef<[u8]>, R: TryFrom<Vec<u8>> + 'static>( &self, keys: &[K], on: u32, ) -> Result<Box<dyn Iterator<Item = Result<(Vec<Vec<u8>>, u64, R), SuberError>> + '_>, SuberError>
where <R as TryFrom<Vec<u8>>>::Error: Debug, SuberError: From<<R as TryFrom<Vec<u8>>>::Error>,

Returns an iterator that yields triples of (keys, on, val) in reverse order

Source

pub fn cnt_on<K: AsRef<[u8]>>( &self, keys: &[K], on: u32, ) -> Result<usize, SuberError>

Counts the number of values with ordinal number suffix

§Returns
  • Count of all ordinal suffix keyed vals with same key prefix but different on in onkey
§Parameters
  • keys - Top keys as prefix to be combined with serialized on suffix and sep to form top key
  • on - Ordinal number used to form key
Source

pub fn get_item_iter<K: AsRef<[u8]>>( &self, keys: &[K], topive: bool, ) -> Result<Vec<(Vec<Vec<u8>>, Vec<u8>)>, SuberError>

Returns an iterator over all the items (keys, value) whose effective key starts with the prefix derived from keys.

§Arguments
  • keys - Slice of key parts, potentially a partial key
  • topive - If true, treat as partial key tuple ending with separator
§Returns
  • Result<Vec<(Vec<Vec<u8>>, Vec<u8>)>, SuberError> - Vector of key-value pairs
Source

pub fn add<K: AsRef<[u8]>, V: ?Sized + Clone + Into<Vec<u8>>>( &self, keys: &[K], val: &V, ) -> Result<bool, SuberError>

Add val idempotently at key made from keys in insertion order using hidden ordinal proem. Idempotently means do not add val that is already in dup vals at key. Does not overwrite.

§Arguments
  • keys - Slice of key parts to be combined to form the key
  • val - Value to be stored
§Returns
  • Result<bool, SuberError> - True means unique value added among duplications, False means duplicate of same value already exists.
Source

pub fn get_last<K: AsRef<[u8]>, R: TryFrom<Vec<u8>>>( &self, keys: &[K], ) -> Result<Option<R>, SuberError>
where <R as TryFrom<Vec<u8>>>::Error: Debug,

Gets the last value inserted at the given keys.

§Arguments
  • keys: An array slice of key parts.
§Returns

Ok(Some(R)) containing the deserialized last value if found. Ok(None) if the key does not exist or has no values. Err(SuberError) on key processing or database/deserialization errors.

Source

pub fn get_io_dup_val_last<K: AsRef<[u8]>, R: TryFrom<Vec<u8>>>( &self, keys: &[K], ) -> Result<Option<R>, SuberError>
where <R as TryFrom<Vec<u8>>>::Error: Debug,

Source

pub fn get<K: AsRef<[u8]>, R: TryFrom<Vec<u8>>>( &self, keys: &[K], ) -> Result<Vec<R>, SuberError>
where <R as TryFrom<Vec<u8>>>::Error: Debug,

Source

pub fn is_dupsort(&self) -> bool

Auto Trait Implementations§

§

impl<C> Freeze for OnIoDupSuber<C>

§

impl<C> RefUnwindSafe for OnIoDupSuber<C>
where C: RefUnwindSafe,

§

impl<C> Send for OnIoDupSuber<C>
where C: Send,

§

impl<C> Sync for OnIoDupSuber<C>
where C: Sync,

§

impl<C> Unpin for OnIoDupSuber<C>
where C: Unpin,

§

impl<C> UnsafeUnpin for OnIoDupSuber<C>

§

impl<C> UnwindSafe for OnIoDupSuber<C>
where C: UnwindSafe,

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> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
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> Same for T

Source§

type Output = T

Should always be Self
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.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more