Struct heed::RoTxn

source ·
pub struct RoTxn<'e> { /* private fields */ }
Expand description

A read-only transaction.

§LMDB Limitations

It’s a must to keep read transactions short-lived.

Active Read transactions prevent the reuse of pages freed by newer write transactions, thus the database can grow quickly.

§OSX/Darwin Limitation

At least 10 transactions can be active at the same time in the same process, since only 10 POSIX semaphores can be active at the same time for a process. Threads are in the same process space.

If the process crashes in the POSIX semaphore locking section of the transaction, the semaphore will be kept locked.

Note: if your program already use POSIX semaphores, you will have less available for heed/LMDB!

You may increase the limit by editing it at your own risk: /Library/LaunchDaemons/sysctl.plist

Implementations§

source§

impl<'e> RoTxn<'e>

source

pub fn commit(self) -> Result<()>

Commit a read transaction.

Synchronizing some Env metadata with the global handle.

§LMDB

It’s mandatory in a multi-process setup to call RoTxn::commit upon read-only database opening. After the transaction opening, the database is dropped. The next transaction might return Io(Os { code: 22, kind: InvalidInput, message: "Invalid argument" }) known as EINVAL.

Trait Implementations§

source§

impl Drop for RoTxn<'_>

source§

fn drop(&mut self)

Executes the destructor for this type. Read more
source§

impl Send for RoTxn<'_>

Auto Trait Implementations§

§

impl<'e> Freeze for RoTxn<'e>

§

impl<'e> RefUnwindSafe for RoTxn<'e>

§

impl<'e> !Sync for RoTxn<'e>

§

impl<'e> Unpin for RoTxn<'e>

§

impl<'e> UnwindSafe for RoTxn<'e>

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

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.

Layout§

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 24 bytes