Struct Cursor 

pub struct Cursor<'a, T: Translator, V: Eq> { /* private fields */ }

A mutable iterator over the values associated with a translated key, allowing in-place modifications.

The Cursor provides a way to traverse and modify the linked list of Records while maintaining its structure. It supports:

• Iteration via next() to access values.
• Modification via update() to change the current value.
• Insertion via insert() to add new values.
• Deletion via delete() to remove values.

Safety

• Must call next() before update(), insert(), or delete() to establish a valid position.
• Once next() returns None, only insert() can be called.
• Dropping the Cursor automatically restores the list structure by reattaching any detached next nodes.

If you don’t need advanced functionality, just use insert(), insert_and_prune(), or remove() instead.

Implementations

impl<'a, T: Translator, V: Eq> Cursor<'a, T, V>

pub fn update(&mut self, v: V)

Updates the value at the current position in the iteration.

Panics if called before next() or after iteration is complete (Status::Done phase).

pub fn next(&mut self) -> Option<&V>

Advances the cursor to the next value in the chain, returning a reference to it.

This method must be called before any other operations (insert(), delete(), etc.). If either insert() or delete() is called, next() must be called to set a new active item. If after insert(), the next active item is the item after the inserted item. If after delete(), the next active item is the item after the deleted item.

Handles transitions between phases and adjusts for deletions. Returns None when the list is exhausted. It is safe to call next() even after it returns None.

pub fn insert(&mut self, v: V)

Inserts a new value at the current position.

pub fn delete(&mut self)

Deletes the current value, adjusting the list structure.

Trait Implementations

impl<T: Translator, V: Eq> Drop for Cursor<'_, T, V>

fn drop(&mut self)

Executes the destructor for this type.

impl<'a, T, V> Send for Cursor<'a, T, V>

where T: Translator + Send, T::Key: Send, V: Eq + Send,