lmdb Namespace Reference

Namespaces
namespace	stream

Classes
struct	close_env
	Closes LMDB environment handle. More...
struct	context
	Context given to LMDB. More...
class	database
	Manages a LMDB environment for safe memory-map resizing. Thread-safe. More...
class	key_iterator
class	key_stream
struct	table
	Helper for grouping typical LMDB DBI options. More...
struct	basic_table
	Helper for grouping typical LMDB DBI options when key and value are fixed types. More...
struct	abort_txn
struct	release_read_txn
struct	abort_write_txn
struct	close_cursor
struct	identity
	Prevent instantiation of std::underlying_type<T> when T is not enum. More...
class	value_iterator
class	value_stream

Typedefs
using	environment = std::unique_ptr<MDB_env, close_env>
using	suspended_txn = std::unique_ptr<MDB_txn, abort_txn>
using	read_txn = std::unique_ptr<MDB_txn, release_read_txn>
using	write_txn = std::unique_ptr<MDB_txn, abort_write_txn>
template<typename T>
using	native_type

Enumerations
enum class	error : int
	Tracks LMDB error codes. More...

Functions
expect< environment >	open_environment (const char *path, MDB_dbi max_dbs) noexcept
std::error_category const &	error_category () noexcept
std::error_code	make_error_code (error value) noexcept
template<typename K, typename V>
bool	operator== (key_iterator< K, V > const &lhs, key_iterator< K, V > const &rhs) noexcept
template<typename K, typename V>
bool	operator!= (key_iterator< K, V > const &lhs, key_iterator< K, V > const &rhs) noexcept
template<typename D>
expect< std::unique_ptr< MDB_cursor, D > >	open_cursor (MDB_txn &txn, MDB_dbi tbl) noexcept
template<typename T, typename U = typename std::underlying_type<T>::type>
constexpr U	to_native (T value) noexcept
template<typename T>
MDB_val	to_val (T &&value) noexcept
constexpr epee::span< const std::uint8_t >	to_byte_span (MDB_val value) noexcept
template<typename T, std::size_t offset = 0>
int	less (MDB_val const *left, MDB_val const *right) noexcept
template<typename T, std::size_t offset = 0>
int	compare (MDB_val const *left, MDB_val const *right) noexcept
template<typename T, typename F, std::size_t offset>
bool	operator== (value_iterator< T, F, offset > const &lhs, value_iterator< T, F, offset > const &rhs) noexcept
template<typename T, typename F, std::size_t offset>
bool	operator!= (value_iterator< T, F, offset > const &lhs, value_iterator< T, F, offset > const &rhs) noexcept

Typedef Documentation

environment

using lmdb::environment = std::unique_ptr<MDB_env, close_env>

native_type

template<typename T>

using lmdb::native_type

Initial value:

typename std::conditional<
       std::is_enum<T>::value, std::underlying_type<T>, identity<T>
   >::type::type

Get the native type for enums, or return T unchanged. Useful for merging generated machine code for templated functions that use enums with identical size-widths without relying on aggressive identical comdat folding (ICF) support in linker. So with enum defintion enum class enum_foo : unsigned long {}; will always yield assert(&func_foo<unsigned long> == &func_foo<native_type<enum_foo>>).

read_txn

using lmdb::read_txn = std::unique_ptr<MDB_txn, release_read_txn>

suspended_txn

using lmdb::suspended_txn = std::unique_ptr<MDB_txn, abort_txn>

write_txn

using lmdb::write_txn = std::unique_ptr<MDB_txn, abort_write_txn>

Enumeration Type Documentation

error

enum class lmdb::error : int

strong

Tracks LMDB error codes.

Function Documentation

compare()

template<typename T, std::size_t offset = 0>

int lmdb::compare ( MDB_val const * left, MDB_val const * right )

inlinenoexcept

A LMDB comparison function that uses std::memcmp.

\toaram T has standard layout and an alignment of 1

Template Parameters

offset

to T within the value.

Returns

The result of std::memcmp over the value.

error_category()

std::error_category const & lmdb::error_category ( )

noexcept

less()

template<typename T, std::size_t offset = 0>

int lmdb::less ( MDB_val const * left, MDB_val const * right )

inlinenoexcept

A LMDB comparison function that uses operator<.

Template Parameters

T	has a defined operator< .
offset	to T within the value.

Returns

-1 if left < right, 1 if right < left, and 0 otherwise.

make_error_code()

std::error_code lmdb::make_error_code ( error value )

inlinenoexcept

open_cursor()

template<typename D>

expect< std::unique_ptr< MDB_cursor, D > > lmdb::open_cursor ( MDB_txn & txn, MDB_dbi tbl )

inlinenoexcept

open_environment()

expect< environment > lmdb::open_environment ( const char * path, MDB_dbi max_dbs )

noexcept

Returns

LMDB environment at path with a max of max_dbs tables.

operator!=() [1/2]

template<typename K, typename V>

bool lmdb::operator!= ( key_iterator< K, V > const & lhs, key_iterator< K, V > const & rhs )

inlinenoexcept

operator!=() [2/2]

template<typename T, typename F, std::size_t offset>

bool lmdb::operator!= ( value_iterator< T, F, offset > const & lhs, value_iterator< T, F, offset > const & rhs )

inlinenoexcept

operator==() [1/2]

template<typename K, typename V>

bool lmdb::operator== ( key_iterator< K, V > const & lhs, key_iterator< K, V > const & rhs )

inlinenoexcept

operator==() [2/2]

template<typename T, typename F, std::size_t offset>

bool lmdb::operator== ( value_iterator< T, F, offset > const & lhs, value_iterator< T, F, offset > const & rhs )

inlinenoexcept

to_byte_span()

epee::span< const std::uint8_t > lmdb::to_byte_span ( MDB_val value )

inlineconstexprnoexcept

Returns

A span over the same chunk of memory as value.

to_native()

template<typename T, typename U = typename std::underlying_type<T>::type>

U lmdb::to_native ( T value )

inlineconstexprnoexcept

Returns

value as its native type.

to_val()

template<typename T>

MDB_val lmdb::to_val ( T && value )

inlinenoexcept

Returns

value bytes in a LMDB MDB_val object.