Struct std::collections::linked_list::Cursor

pub struct Cursor<'a, T, A = Global>where
    T: 'a,
    A: Allocator,{ /* private fields */ }

🔬This is a nightly-only experimental API. (linked_list_cursors #58533)

LinkedList 上的游标。

Cursor 类似于迭代器，不同之处在于它可以自由地来回查找。

游标始终位于列表中的两个元素之间，并以逻辑循环的方式进行索引。 为了适应这一点，有一个 “ghost” 非元素在列表的开头和结尾之间产生 None。

创建后，游标从列表的开头开始，如果列表为空，则从 “ghost” 非元素开始。

Implementations

impl<'a, T, A> Cursor<'a, T, A>where A: Allocator,

pub fn index(&self) -> Option<usize>

🔬This is a nightly-only experimental API. (linked_list_cursors #58533)

返回 LinkedList 中的游标位置索引。

如果游标当前指向 “ghost” 非元素，则返回 None。

pub fn move_next(&mut self)

🔬This is a nightly-only experimental API. (linked_list_cursors #58533)

将游标移动到 LinkedList 的下一个元素。

如果游标指向 “ghost” 非元素，那么它将移动到 LinkedList 的第一个元素。 如果它指向 LinkedList 的最后一个元素，那么它将把它移到 “ghost” 非元素。

pub fn move_prev(&mut self)

🔬This is a nightly-only experimental API. (linked_list_cursors #58533)

将游标移动到 LinkedList 的上一个元素。

如果游标指向 “ghost” 非元素，那么它将移动到 LinkedList 的最后一个元素。 如果它指向 LinkedList 的第一个元素，那么它将把它移到 “ghost” 非元素。

pub fn current(&self) -> Option<&'a T>

🔬This is a nightly-only experimental API. (linked_list_cursors #58533)

返回对游标当前指向的元素的引用。

如果游标当前指向 “ghost” 非元素，则返回 None。

pub fn peek_next(&self) -> Option<&'a T>

🔬This is a nightly-only experimental API. (linked_list_cursors #58533)

返回下一个元素的引用。

如果游标指向 “ghost” 非元素，则返回 LinkedList 的第一个元素。 如果它指向 LinkedList 的最后一个元素，则返回 None。

pub fn peek_prev(&self) -> Option<&'a T>

🔬This is a nightly-only experimental API. (linked_list_cursors #58533)

返回上一个元素的引用。

如果游标指向 “ghost” 非元素，则返回 LinkedList 的最后一个元素。 如果它指向 LinkedList 的第一个元素，则返回 None。

pub fn front(&self) -> Option<&'a T>

🔬This is a nightly-only experimental API. (linked_list_cursors #58533)

提供对游标父列表前元素的引用，如果列表为空，则为 None。

pub fn back(&self) -> Option<&'a T>

🔬This is a nightly-only experimental API. (linked_list_cursors #58533)

提供对游标父列表的后部元素的引用，如果列表为空，则为 None。

Trait Implementations

impl<T, A> Clone for Cursor<'_, T, A>where A: Allocator,

fn clone(&self) -> Cursor<'_, T, A>

返回值的副本。

fn clone_from(&mut self, source: &Self)

从 source 执行复制分配。

impl<T, A> Debug for Cursor<'_, T, A>where T: Debug, A: Allocator,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

使用给定的格式化程序格式化该值。

impl<T, A> Send for Cursor<'_, T, A>where T: Sync, A: Allocator + Sync,

impl<T, A> Sync for Cursor<'_, T, A>where T: Sync, A: Allocator + Sync,