Struct rql::Table

pub struct Table<T> { /* fields omitted */ }

A table abstraction akin to a table in a real schema

Methods

impl<T> Table<T>

pub fn new() -> Self

Create a new Table

pub fn len(&self) -> usize

Get the number of rows in the Table

pub fn is_empty(&self) -> bool

Check if the Table` is empty

pub fn insert(&mut self, row: T) -> Id<T>

Insert a row into the Table

pub fn get(&self, id: Id<T>) -> Option<&T>

Try to get a reference to the row with the given Id

pub fn get_mut(&mut self, id: Id<T>) -> Option<&mut T>

Try to get a mutable reference to the row with the given Id

pub fn remove(&mut self, id: Id<T>) -> Option<T>

Remove the row with the given Id

pub fn rows(&self) -> RowIter<T>

Iterate over all rows in the Table

pub fn rows_mut(&mut self) -> RowIterMut<T>

Iterate mutably over all rows in the Table

pub fn delete_one(&mut self, id: Id<T>) -> Option<T>

Delete a single row based on its Id and return the value

pub fn delete_where<F>(&mut self, f: F) -> usize where
    F: Fn(&T) -> bool, 

Delete rows that satisfy the clause

Returns how many rows where deleted

pub fn delete_iter<'a, F, I, R>(&'a mut self, f: F) where
    F: Fn(&'a Self) -> I,
    I: IntoIterator<Item = R>,
    R: Idd<RowType = T>, 

Delete rows with ids returned by an iterator

impl<T> Table<T> where
    T: Serialize, 

pub fn save<P>(&self, path: P, repr: Representation) -> Result<()> where
    P: AsRef<Path>, 

Save the database to a file

pub fn save_to_bytes(&self, repr: Representation) -> Result<Vec<u8>>

Save the database to a byte vector

impl<T> Table<T> where
    T: DeserializeOwned, 

pub fn load<P>(path: P, repr: Representation) -> Result<Self> where
    P: AsRef<Path>, 

Load a database from a file

pub fn load_from_bytes<B: AsRef<[u8]>>(
    bytes: B,
    repr: Representation
) -> Result<Self>

Load a database from a byte array

Trait Implementations

impl<T: Clone> Clone for Table<T>

fn clone(&self) -> Table<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Table<T> where
    T: Debug, 

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

Formats the value using the given formatter.

impl<T> Default for Table<T>

fn default() -> Self

Returns the "default value" for a type.

impl<'de, T> Deserialize<'de> for Table<T> where
    T: Deserialize<'de>, 

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<'a, T> HasRows for &'a Table<T>

type Iter = RowIter<'a, T>

The row iterator type

fn rows(self) -> Self::Iter

Get the row iterator

fn select<F, R>(self, f: F) -> Select<Self::Iter, F> where
    F: Fn(<Self::Iter as Iterator>::Item) -> R, 

Create a selection

fn relate<R, F>(self, other: R, f: F) -> Relate<Self::Iter, R::Iter, F> where
    R: HasRows,
    R::Iter: Clone,
    <Self::Iter as Iterator>::Item: Clone,
    F: Fn(&<Self::Iter as Iterator>::Item, &<R::Iter as Iterator>::Item) -> bool, 

Relate this HasRows to another

fn wher<F>(self, f: F) -> Where<Self::Iter, F> where
    F: Fn(&<Self::Iter as Iterator>::Item) -> bool, 

Restricts the rows with a WHERE clause

fn find<F>(self, f: F) -> Option<<Self::Iter as Iterator>::Item> where
    F: Fn(&<Self::Iter as Iterator>::Item) -> bool, 

Tries to find a row that satisfies the clause

impl<'a, T> HasRows for &'a mut Table<T>

type Iter = RowIter<'a, T>

The row iterator type

fn rows(self) -> Self::Iter

Get the row iterator

fn select<F, R>(self, f: F) -> Select<Self::Iter, F> where
    F: Fn(<Self::Iter as Iterator>::Item) -> R, 

Create a selection

fn relate<R, F>(self, other: R, f: F) -> Relate<Self::Iter, R::Iter, F> where
    R: HasRows,
    R::Iter: Clone,
    <Self::Iter as Iterator>::Item: Clone,
    F: Fn(&<Self::Iter as Iterator>::Item, &<R::Iter as Iterator>::Item) -> bool, 

Relate this HasRows to another

fn wher<F>(self, f: F) -> Where<Self::Iter, F> where
    F: Fn(&<Self::Iter as Iterator>::Item) -> bool, 

Restricts the rows with a WHERE clause

fn find<F>(self, f: F) -> Option<<Self::Iter as Iterator>::Item> where
    F: Fn(&<Self::Iter as Iterator>::Item) -> bool, 

Tries to find a row that satisfies the clause

impl<'a, T> HasRowsMut for &'a mut Table<T>

type Iter = RowIterMut<'a, T>

The row iterator type

fn rows_mut(self) -> Self::Iter

Get the row iterator

fn update(self) -> Self::Iter

Update the rows

impl<T> Serialize for Table<T> where
    T: Serialize, 

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.