Struct native_db::transaction::query::PrimaryScan

source ·
pub struct PrimaryScan<PrimaryTable, T: Input>
where PrimaryTable: ReadableTable<DatabaseInnerKeyValue, &'static [u8]>,
{ /* private fields */ }
Expand description

Scan values from the database.

Implementations§

source§

impl<PrimaryTable, T: Input> PrimaryScan<PrimaryTable, T>
where PrimaryTable: ReadableTable<DatabaseInnerKeyValue, &'static [u8]>,

source

pub fn all(&self) -> PrimaryScanIterator<'_, T>

Iterate over all values.

§Example
use native_db::*;
use native_model::{native_model, Model};
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
#[native_model(id=1, version=1)]
#[native_db]
struct Data {
    #[primary_key]
    id: u64,
}

fn main() -> Result<(), db_type::Error> {
    let mut builder = DatabaseBuilder::new();
    builder.define::<Data>()?;
    let db = builder.create_in_memory()?;
     
    // Open a read transaction
    let r = db.r_transaction()?;
     
    // Get all values
    let _values: Vec<Data> = r.scan().primary()?.all().collect();
    Ok(())
}
source

pub fn range<TR: InnerKeyValue, R: RangeBounds<TR>>( &self, range: R ) -> PrimaryScanIterator<'_, T>

Iterate over all values in a range.

§Example
use native_db::*;
use native_model::{native_model, Model};
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
#[native_model(id=1, version=1)]
#[native_db]
struct Data {
    #[primary_key]
    id: u64,
}

fn main() -> Result<(), db_type::Error> {
    let mut builder = DatabaseBuilder::new();
    builder.define::<Data>()?;
    let db = builder.create_in_memory()?;
     
    // Open a read transaction
    let r = db.r_transaction()?;
     
    // Get the values from 5 to the end
    let _values: Vec<Data> = r.scan().primary()?.range(5u64..).collect();
    Ok(())
}
source

pub fn start_with<'a>( &'a self, start_with: impl InnerKeyValue + 'a ) -> PrimaryScanIteratorStartWith<'a, T>

Iterate over all values starting with a prefix.

§Example
use native_db::*;
use native_model::{native_model, Model};
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
#[native_model(id=1, version=1)]
#[native_db]
struct Data {
    #[primary_key]
    id: String,
}

fn main() -> Result<(), db_type::Error> {
    let mut builder = DatabaseBuilder::new();
    builder.define::<Data>()?;
    let db = builder.create_in_memory()?;
     
    // Open a read transaction
    let r = db.r_transaction()?;
     
    // Get the values starting with "victor"
    let _values: Vec<Data> = r.scan().primary()?.start_with("victor").collect();
    Ok(())
}

Auto Trait Implementations§

§

impl<PrimaryTable, T> Freeze for PrimaryScan<PrimaryTable, T>
where PrimaryTable: Freeze,

§

impl<PrimaryTable, T> RefUnwindSafe for PrimaryScan<PrimaryTable, T>
where PrimaryTable: RefUnwindSafe, T: RefUnwindSafe,

§

impl<PrimaryTable, T> Send for PrimaryScan<PrimaryTable, T>
where PrimaryTable: Send, T: Send,

§

impl<PrimaryTable, T> Sync for PrimaryScan<PrimaryTable, T>
where PrimaryTable: Sync, T: Sync,

§

impl<PrimaryTable, T> Unpin for PrimaryScan<PrimaryTable, T>
where PrimaryTable: Unpin, T: Unpin,

§

impl<PrimaryTable, T> UnwindSafe for PrimaryScan<PrimaryTable, T>
where PrimaryTable: UnwindSafe, T: 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.

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, U> TryFrom<U> for T
where U: Into<T>,

§

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>,

§

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.