Struct Cursor
pub struct Cursor<K>where
K: TransactionKind,{ /* private fields */ }mdbx only.Expand description
A cursor for navigating the items within a database.
Implementations§
§impl<K> Cursor<K>where
K: TransactionKind,
impl<K> Cursor<K>where
K: TransactionKind,
pub const fn cursor(&self) -> *mut MDBX_cursor
pub const fn cursor(&self) -> *mut MDBX_cursor
Returns a raw pointer to the underlying MDBX cursor.
The caller must ensure that the pointer is not used after the lifetime of the cursor.
pub fn iter_slices<'a>(
&'a self,
) -> IntoIter<'a, K, Cow<'a, [u8]>, Cow<'a, [u8]>>
pub fn iter_slices<'a>( &'a self, ) -> IntoIter<'a, K, Cow<'a, [u8]>, Cow<'a, [u8]>>
Returns an iterator over the raw key value slices.
pub fn into_iter<Key, Value>(&self) -> IntoIter<'_, K, Key, Value>where
Key: TableObject,
Value: TableObject,
pub fn into_iter<Key, Value>(&self) -> IntoIter<'_, K, Key, Value>where
Key: TableObject,
Value: TableObject,
Returns an iterator over database items.
pub fn first<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn first<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
Position at first key/data item.
pub fn first_dup<Value>(&mut self) -> Result<Option<Value>, Error>where
Value: TableObject,
pub fn first_dup<Value>(&mut self) -> Result<Option<Value>, Error>where
Value: TableObject,
DatabaseFlags::DUP_SORT-only: Position at first data item of current key.
pub fn get_both<Value>(
&mut self,
k: &[u8],
v: &[u8],
) -> Result<Option<Value>, Error>where
Value: TableObject,
pub fn get_both<Value>(
&mut self,
k: &[u8],
v: &[u8],
) -> Result<Option<Value>, Error>where
Value: TableObject,
DatabaseFlags::DUP_SORT-only: Position at key/data pair.
pub fn get_both_range<Value>(
&mut self,
k: &[u8],
v: &[u8],
) -> Result<Option<Value>, Error>where
Value: TableObject,
pub fn get_both_range<Value>(
&mut self,
k: &[u8],
v: &[u8],
) -> Result<Option<Value>, Error>where
Value: TableObject,
DatabaseFlags::DUP_SORT-only: Position at given key and at first data greater than or
equal to specified data.
pub fn get_current<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn get_current<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
Return key/data at current cursor position.
pub fn get_multiple<Value>(&mut self) -> Result<Option<Value>, Error>where
Value: TableObject,
pub fn get_multiple<Value>(&mut self) -> Result<Option<Value>, Error>where
Value: TableObject,
DupFixed-only: Return up to a page of duplicate data items from current cursor position.
Move cursor to prepare for Self::next_multiple().
pub fn last<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn last<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
Position at last key/data item.
pub fn last_dup<Value>(&mut self) -> Result<Option<Value>, Error>where
Value: TableObject,
pub fn last_dup<Value>(&mut self) -> Result<Option<Value>, Error>where
Value: TableObject,
DupSort-only: Position at last data item of current key.
pub fn next<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn next<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
Position at next data item
pub fn next_dup<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn next_dup<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
DatabaseFlags::DUP_SORT-only: Position at next data item of current key.
pub fn next_multiple<Key, Value>(
&mut self,
) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn next_multiple<Key, Value>(
&mut self,
) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
DatabaseFlags::DUP_FIXED-only: Return up to a page of duplicate data items from next
cursor position. Move cursor to prepare for MDBX_NEXT_MULTIPLE.
pub fn next_nodup<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn next_nodup<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
Position at first data item of next key.
pub fn prev<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn prev<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
Position at previous data item.
pub fn prev_dup<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn prev_dup<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
DatabaseFlags::DUP_SORT-only: Position at previous data item of current key.
pub fn prev_nodup<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn prev_nodup<Key, Value>(&mut self) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
Position at last data item of previous key.
pub fn set<Value>(&mut self, key: &[u8]) -> Result<Option<Value>, Error>where
Value: TableObject,
pub fn set<Value>(&mut self, key: &[u8]) -> Result<Option<Value>, Error>where
Value: TableObject,
Position at specified key.
pub fn set_key<Key, Value>(
&mut self,
key: &[u8],
) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn set_key<Key, Value>(
&mut self,
key: &[u8],
) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
Position at specified key, return both key and data.
pub fn set_range<Key, Value>(
&mut self,
key: &[u8],
) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn set_range<Key, Value>(
&mut self,
key: &[u8],
) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
Position at first key greater than or equal to specified key.
pub fn prev_multiple<Key, Value>(
&mut self,
) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn prev_multiple<Key, Value>(
&mut self,
) -> Result<Option<(Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
DatabaseFlags::DUP_FIXED-only: Position at previous page and return up to a page of
duplicate data items.
pub fn set_lowerbound<Key, Value>(
&mut self,
key: &[u8],
) -> Result<Option<(bool, Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
pub fn set_lowerbound<Key, Value>(
&mut self,
key: &[u8],
) -> Result<Option<(bool, Key, Value)>, Error>where
Key: TableObject,
Value: TableObject,
Position at first key-value pair greater than or equal to specified, return both key and data, and the return code depends on a exact match.
For non DupSort-ed collections this works the same as Self::set_range(), but returns
false if key found exactly and true if greater key was found.
For DupSort-ed a data value is taken into account for duplicates, i.e. for a pairs/tuples of a key and an each data value of duplicates. Returns false if key-value pair found exactly and true if the next pair was returned.
pub fn iter<Key, Value>(&mut self) -> Iter<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
pub fn iter<Key, Value>(&mut self) -> Iter<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
Returns an iterator over database items.
The iterator will begin with item next after the cursor, and continue until the end of the database. For new cursors, the iterator will begin with the first item in the database.
For databases with duplicate data items (DatabaseFlags::DUP_SORT), the
duplicate data items of each key will be returned before moving on to
the next key.
pub fn iter_start<Key, Value>(&mut self) -> Iter<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
pub fn iter_start<Key, Value>(&mut self) -> Iter<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
Iterate over database items starting from the beginning of the database.
For databases with duplicate data items (DatabaseFlags::DUP_SORT), the
duplicate data items of each key will be returned before moving on to
the next key.
pub fn iter_from<Key, Value>(&mut self, key: &[u8]) -> Iter<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
pub fn iter_from<Key, Value>(&mut self, key: &[u8]) -> Iter<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
Iterate over database items starting from the given key.
For databases with duplicate data items (DatabaseFlags::DUP_SORT), the
duplicate data items of each key will be returned before moving on to
the next key.
pub fn iter_dup<Key, Value>(&mut self) -> IterDup<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
pub fn iter_dup<Key, Value>(&mut self) -> IterDup<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
Iterate over duplicate database items. The iterator will begin with the item next after the cursor, and continue until the end of the database. Each item will be returned as an iterator of its duplicates.
pub fn iter_dup_start<Key, Value>(&mut self) -> IterDup<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
pub fn iter_dup_start<Key, Value>(&mut self) -> IterDup<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
Iterate over duplicate database items starting from the beginning of the database. Each item will be returned as an iterator of its duplicates.
pub fn iter_dup_from<Key, Value>(
&mut self,
key: &[u8],
) -> IterDup<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
pub fn iter_dup_from<Key, Value>(
&mut self,
key: &[u8],
) -> IterDup<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
Iterate over duplicate items in the database starting from the given key. Each item will be returned as an iterator of its duplicates.
pub fn iter_dup_of<Key, Value>(&mut self, key: &[u8]) -> Iter<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
pub fn iter_dup_of<Key, Value>(&mut self, key: &[u8]) -> Iter<'_, K, Key, Value> ⓘwhere
Key: TableObject,
Value: TableObject,
Iterate over the duplicates of the item in the database with the given key.
§impl Cursor<RW>
impl Cursor<RW>
pub fn put(
&mut self,
key: &[u8],
data: &[u8],
flags: WriteFlags,
) -> Result<(), Error>
pub fn put( &mut self, key: &[u8], data: &[u8], flags: WriteFlags, ) -> Result<(), Error>
Puts a key/data pair into the database. The cursor will be positioned at the new data item, or on failure usually near it.
pub fn del(&mut self, flags: WriteFlags) -> Result<(), Error>
pub fn del(&mut self, flags: WriteFlags) -> Result<(), Error>
Deletes the current key/data pair.
§Flags
WriteFlags::NO_DUP_DATA may be used to delete all data items for the
current key, if the database was opened with DatabaseFlags::DUP_SORT.
Trait Implementations§
§impl<K> Clone for Cursor<K>where
K: TransactionKind,
impl<K> Clone for Cursor<K>where
K: TransactionKind,
§impl<K> Debug for Cursor<K>where
K: TransactionKind,
impl<K> Debug for Cursor<K>where
K: TransactionKind,
§impl<K> Drop for Cursor<K>where
K: TransactionKind,
impl<K> Drop for Cursor<K>where
K: TransactionKind,
impl<K> Send for Cursor<K>where
K: TransactionKind,
impl<K> Sync for Cursor<K>where
K: TransactionKind,
Auto Trait Implementations§
impl<K> Freeze for Cursor<K>
impl<K> !RefUnwindSafe for Cursor<K>
impl<K> Unpin for Cursor<K>
impl<K> !UnwindSafe for Cursor<K>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> Conv for T
impl<T> Conv for T
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self to use its Binary implementation when Debug-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self to use its Display implementation when
Debug-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self to use its LowerExp implementation when
Debug-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self to use its LowerHex implementation when
Debug-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self to use its Octal implementation when Debug-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self to use its Pointer implementation when
Debug-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self to use its UpperExp implementation when
Debug-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self to use its UpperHex implementation when
Debug-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self, then passes self.as_ref() into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self, then passes self.as_mut() into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self, then passes self.deref() into the pipe function.§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B> of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B> of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R> view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R> view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap() only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut() only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow() only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut() only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref() only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut() only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref() only in debug builds, and is erased in release
builds.§impl<T> TryConv for T
impl<T> TryConv for T
§impl<T> WithSubscriber for T
impl<T> WithSubscriber for T
§fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
§fn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
impl<T> MaybeDebug for Twhere
T: Debug,
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: 16 bytes