Trait sanakirja::Representable

pub trait Representable: Copy + Debug {
    type PageOffsets: Iterator<Item = u64>;
    pub fn onpage_size(&self) -> u16;
    pub unsafe fn write_value(&self, p: *mut u8);
    pub unsafe fn read_value(p: *const u8) -> Self;
    pub unsafe fn cmp_value<T: LoadPage>(&self, txn: &T, x: Self) -> Ordering;
    pub fn page_offsets(&self) -> Self::PageOffsets;

    pub fn alignment() -> Alignment { ... }
    pub unsafe fn skip(p: *mut u8) -> *mut u8 { ... }
    pub fn drop_value<E: Borrow<Env<Exclusive>>, T, R: Rng>(
        &self, 
        _: &mut MutTxn<E, T>, 
        _: &mut R
    ) -> Result<(), Error> { ... }
}

Types that can be stored in a Sanakirja database, as keys or values. Some care must be taken when storing things.

Associated Types

type PageOffsets: Iterator<Item = u64>

An iterator over the offsets to pages contained in this value. Only values from this crate can generate non-empty iterators, but combined values (like tuples) must chain the iterators returned by method page_offsets.

Loading content...

Required methods

pub fn onpage_size(&self) -> u16

How much space this value occupies on the page (not counting alignment padding).

pub unsafe fn write_value(&self, p: *mut u8)

Write this value to a u8 pointer, guaranteed to be a multiple of self.alignment().

pub unsafe fn read_value(p: *const u8) -> Self

Read value from an onpage pointer, guaranteed to be a multiple of self.alignment().

pub unsafe fn cmp_value<T: LoadPage>(&self, txn: &T, x: Self) -> Ordering

Compare a value with an onpage value. The current transaction is sometimes helpful, for instance when the page only stores a pointer to another page.

pub fn page_offsets(&self) -> Self::PageOffsets

If this value is an offset to another page at offset offset, return Some(offset). Return None else.

Loading content...

Provided methods

pub fn alignment() -> Alignment

Alignment of this type. Allowed values are 1, 2, 4 and 8.

pub unsafe fn skip(p: *mut u8) -> *mut u8

First pointer strictly after this value's pointer. The default implementation is basically p.offset(self.onpage_size() as isize), but their might be more efficient implementations in some cases.

pub fn drop_value<E: Borrow<Env<Exclusive>>, T, R: Rng>(
    &self,
    _: &mut MutTxn<E, T>,
    _: &mut R
) -> Result<(), Error>

How to free the pages used by this value. The default implementation doesn't do anything, which is fine for types stored directly on B tree pages.

Loading content...

Implementations on Foreign Types

impl<A: Representable, B: Representable> Representable for (A, B)

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, txn: &T, x: Self) -> Ordering

type PageOffsets = Chain<A::PageOffsets, B::PageOffsets>

pub fn page_offsets(&self) -> Self::PageOffsets

pub fn drop_value<E: Borrow<Env<Exclusive>>, T, R: Rng>(
    &self,
    txn: &mut MutTxn<E, T>,
    rng: &mut R
) -> Result<(), Error>

impl<A: Representable, B: Representable, C: Representable> Representable for (A, B, C)

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, txn: &T, x: Self) -> Ordering

type PageOffsets = Chain<Chain<A::PageOffsets, B::PageOffsets>, C::PageOffsets>

pub fn page_offsets(&self) -> Self::PageOffsets

pub fn drop_value<E: Borrow<Env<Exclusive>>, T, R: Rng>(
    &self,
    txn: &mut MutTxn<E, T>,
    rng: &mut R
) -> Result<(), Error>

impl<A: Representable, B: Representable, C: Representable, D: Representable> Representable for (A, B, C, D)

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, txn: &T, x: Self) -> Ordering

type PageOffsets = Chain<Chain<A::PageOffsets, B::PageOffsets>, Chain<C::PageOffsets, D::PageOffsets>>

pub fn page_offsets(&self) -> Self::PageOffsets

pub fn drop_value<E: Borrow<Env<Exclusive>>, T, R: Rng>(
    &self,
    txn: &mut MutTxn<E, T>,
    rng: &mut R
) -> Result<(), Error>

impl<A: Representable, B: Representable, C: Representable, D: Representable, E: Representable> Representable for (A, B, C, D, E)

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, txn: &T, x: Self) -> Ordering

type PageOffsets = Chain<Chain<Chain<Chain<A::PageOffsets, B::PageOffsets>, C::PageOffsets>, D::PageOffsets>, E::PageOffsets>

pub fn page_offsets(&self) -> Self::PageOffsets

pub fn drop_value<Env_: Borrow<Env<Exclusive>>, T, R: Rng>(
    &self,
    txn: &mut MutTxn<Env_, T>,
    rng: &mut R
) -> Result<(), Error>

impl<A: Representable, B: Representable, C: Representable, D: Representable, E: Representable, F: Representable> Representable for (A, B, C, D, E, F)

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, txn: &T, x: Self) -> Ordering

type PageOffsets = Chain<Chain<Chain<Chain<Chain<A::PageOffsets, B::PageOffsets>, C::PageOffsets>, D::PageOffsets>, E::PageOffsets>, F::PageOffsets>

pub fn page_offsets(&self) -> Self::PageOffsets

pub fn drop_value<Env_: Borrow<Env<Exclusive>>, T, R: Rng>(
    &self,
    txn: &mut MutTxn<Env_, T>,
    rng: &mut R
) -> Result<(), Error>

impl Representable for f64

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn skip(p: *mut u8) -> *mut u8

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, _: &T, x: Self) -> Ordering

type PageOffsets = Empty<u64>

pub fn page_offsets(&self) -> Self::PageOffsets

impl Representable for u64

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn skip(p: *mut u8) -> *mut u8

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, _: &T, x: Self) -> Ordering

type PageOffsets = Empty<u64>

pub fn page_offsets(&self) -> Self::PageOffsets

impl Representable for u32

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn skip(p: *mut u8) -> *mut u8

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, _: &T, x: Self) -> Ordering

type PageOffsets = Empty<u64>

pub fn page_offsets(&self) -> Self::PageOffsets

impl Representable for i64

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn skip(p: *mut u8) -> *mut u8

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, _: &T, x: Self) -> Ordering

type PageOffsets = Empty<u64>

pub fn page_offsets(&self) -> Self::PageOffsets

impl Representable for i32

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn skip(p: *mut u8) -> *mut u8

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, _: &T, x: Self) -> Ordering

type PageOffsets = Empty<u64>

pub fn page_offsets(&self) -> Self::PageOffsets

impl Representable for ()

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn skip(p: *mut u8) -> *mut u8

pub unsafe fn write_value(&self, _: *mut u8)

pub unsafe fn read_value(_: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, _: &T, _: Self) -> Ordering

type PageOffsets = Empty<u64>

pub fn page_offsets(&self) -> Self::PageOffsets

impl Representable for Uuid

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn skip(p: *mut u8) -> *mut u8

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, _: &T, x: Self) -> Ordering

type PageOffsets = Empty<u64>

pub fn page_offsets(&self) -> Self::PageOffsets

impl Representable for Oid

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn skip(p: *mut u8) -> *mut u8

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, _: &T, x: Self) -> Ordering

type PageOffsets = Empty<u64>

pub fn page_offsets(&self) -> Self::PageOffsets

Loading content...

Implementors

impl Representable for UnsafeValue

pub fn onpage_size(&self) -> u16

pub unsafe fn write_value(&self, ptr: *mut u8)

pub unsafe fn read_value(ptr: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, txn: &T, y: Self) -> Ordering

pub fn drop_value<E: Borrow<Env<Exclusive>>, T, R>(
    &self,
    txn: &mut MutTxn<E, T>,
    _: &mut R
) -> Result<(), Error>

type PageOffsets = IntoIter<u64>

pub fn page_offsets(&self) -> Self::PageOffsets

impl<K: Representable, V: Representable> Representable for Db<K, V>

pub fn alignment() -> Alignment

pub fn onpage_size(&self) -> u16

pub unsafe fn skip(p: *mut u8) -> *mut u8

pub unsafe fn write_value(&self, p: *mut u8)

pub unsafe fn read_value(p: *const u8) -> Self

pub unsafe fn cmp_value<T: LoadPage>(&self, _: &T, x: Db<K, V>) -> Ordering

type PageOffsets = Once<u64>

pub fn page_offsets(&self) -> Self::PageOffsets

pub fn drop_value<E: Borrow<Env<Exclusive>>, T, R: Rng>(
    &self,
    txn: &mut MutTxn<E, T>,
    rng: &mut R
) -> Result<(), Error>

Loading content...