Struct rpds::sequence::list::List
[−]
[src]
pub struct List<T> { /* fields omitted */ }
A persistent list with structural sharing. This data structure supports fast push_front()
,
drop_first()
, first()
, and last()
.
Complexity
Let n be the number of elements in the list.
Temporal complexity
Operation | Best case | Average | Worst case |
---|---|---|---|
new() | Θ(1) | Θ(1) | Θ(1) |
push_front() | Θ(1) | Θ(1) | Θ(1) |
drop_first() | Θ(1) | Θ(1) | Θ(1) |
reverse() | Θ(n) | Θ(n) | Θ(n) |
first() | Θ(1) | Θ(1) | Θ(1) |
last() | Θ(1) | Θ(1) | Θ(1) |
len() | Θ(1) | Θ(1) | Θ(1) |
clone() | Θ(1) | Θ(1) | Θ(1) |
iterator creation | Θ(1) | Θ(1) | Θ(1) |
iterator step | Θ(1) | Θ(1) | Θ(1) |
iterator full | Θ(n) | Θ(n) | Θ(n) |
Implementation details
This is your classic functional list with "cons" and "nil" nodes, with a little extra sauce to make some operations more efficient.
Methods
impl<T> List<T>
[src]
pub fn new() -> List<T>
[src]
pub fn first(&self) -> Option<&T>
[src]
pub fn last(&self) -> Option<&T>
[src]
pub fn drop_first(&self) -> Option<List<T>>
[src]
pub fn push_front(&self, v: T) -> List<T>
[src]
pub fn reverse(&self) -> List<T>
[src]
pub fn len(&self) -> usize
[src]
pub fn is_empty(&self) -> bool
[src]
pub fn iter(&self) -> Iter<T>
[src]
Trait Implementations
impl<T> Serialize for List<T> where
T: Serialize,
[src]
T: Serialize,
fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>
[src]
Serialize this value into the given Serde serializer. Read more
impl<'de, T> Deserialize<'de> for List<T> where
T: Deserialize<'de>,
[src]
T: Deserialize<'de>,
fn deserialize<D: Deserializer<'de>>(
deserializer: D
) -> Result<List<T>, D::Error>
[src]
deserializer: D
) -> Result<List<T>, D::Error>
Deserialize this value from the given Serde deserializer. Read more
impl<T: Debug> Debug for List<T>
[src]
fn fmt(&self, __arg_0: &mut Formatter) -> Result
[src]
Formats the value using the given formatter. Read more
impl<T> Default for List<T>
[src]
impl<T: PartialEq> PartialEq for List<T>
[src]
fn eq(&self, other: &List<T>) -> bool
[src]
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl<T: Eq> Eq for List<T>
[src]
impl<T: PartialOrd<T>> PartialOrd<List<T>> for List<T>
[src]
fn partial_cmp(&self, other: &List<T>) -> Option<Ordering>
[src]
This method returns an ordering between self
and other
values if one exists. Read more
fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
fn le(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
fn gt(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
fn ge(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl<T: Ord> Ord for List<T>
[src]
fn cmp(&self, other: &List<T>) -> Ordering
[src]
This method returns an Ordering
between self
and other
. Read more
fn max(self, other: Self) -> Self
1.21.0[src]
Compares and returns the maximum of two values. Read more
fn min(self, other: Self) -> Self
1.21.0[src]
Compares and returns the minimum of two values. Read more
impl<T: Hash> Hash for List<T>
[src]
fn hash<H: Hasher>(&self, state: &mut H)
[src]
Feeds this value into the given [Hasher
]. Read more
fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
Feeds a slice of this type into the given [Hasher
]. Read more
impl<T> Clone for List<T>
[src]
fn clone(&self) -> List<T>
[src]
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl<T: Display> Display for List<T>
[src]
fn fmt(&self, fmt: &mut Formatter) -> Result
[src]
Formats the value using the given formatter. Read more
impl<'a, T> IntoIterator for &'a List<T>
[src]
type Item = &'a T
The type of the elements being iterated over.
type IntoIter = Iter<'a, T>
Which kind of iterator are we turning this into?
fn into_iter(self) -> Iter<'a, T>
[src]
Creates an iterator from a value. Read more
impl<T> FromIterator<T> for List<T>
[src]
fn from_iter<I: IntoIterator<Item = T>>(into_iter: I) -> List<T>
[src]
Creates a value from an iterator. Read more