Struct List

pub struct List<T: TransparentPtrType> { /* private fields */ }

A list of items of type T.

Behaves like an Iterator<Item = T> but allows modifications.

Implementations

impl<T: TransparentPtrType> List<T>

pub unsafe fn from_glib_none(list: *const GList) -> List<T>

Create a new List around a list.

pub unsafe fn from_glib_container(list: *mut GList) -> List<T>

Create a new List around a list.

pub unsafe fn from_glib_full(list: *mut GList) -> List<T>

Create a new List around a list.

pub fn new() -> Self

Creates a new empty list.

pub fn iter(&self) -> Iter<'_, T>

Create a non-destructive iterator over the List.

pub fn iter_mut(&mut self) -> IterMut<'_, T>

Create a non-destructive mutable iterator over the List.

pub fn is_empty(&self) -> bool

Check if the list is empty.

This operation is O(1).

pub fn len(&self) -> usize

Returns the length of the list.

This operation is O(n).

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

Returns a reference to the first item of the list, if any.

This operation is O(1).

pub fn front_mut(&mut self) -> Option<&mut T>

Returns a mutable reference to the first item of the list, if any.

This operation is O(1).

pub fn pop_front(&mut self) -> Option<T>

Removes the front item from the list, if any.

This operation is O(1).

pub fn push_front(&mut self, item: T)

Prepends the new item to the front of the list.

This operation is O(1).

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

Returns a reference to the last item of the list, if any.

This operation is O(n).

pub fn back_mut(&mut self) -> Option<&mut T>

Returns a mutable reference to the last item of the list, if any.

This operation is O(n).

pub fn pop_back(&mut self) -> Option<T>

Removes the back item from the list, if any.

This operation is O(n).

pub fn push_back(&mut self, item: T)

Appends the new item to the back of the list.

this operation is O(n).

pub fn reverse(&mut self)

Reverse the list.

This operation is O(n).

pub fn sort(&mut self)

where T: Ord,

Sorts the list.

This operation is O(n * log n).

pub fn sort_by<F: FnMut(&T, &T) -> Ordering>(&mut self, f: F)

Sorts the list.

This operation is O(n * log n).

pub fn clear(&mut self)

Removes all items from the list.

pub fn retain(&mut self, f: impl FnMut(&T) -> bool)

Only keeps the item in the list for which f returns true.

pub fn as_ptr(&self) -> *const GList

Returns the underlying pointer.

pub fn as_mut_ptr(&mut self) -> *mut GList

Returns the underlying pointer.

pub fn into_raw(self) -> *mut GList

Consumes the list and returns the underlying pointer.

Trait Implementations

impl<T: TransparentPtrType> Clone for List<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: TransparentPtrType> Default for List<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T: TransparentPtrType> Drop for List<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: TransparentPtrType> Extend<T> for List<T>

fn extend<I: IntoIterator<Item = T>>(&mut self, iter: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<T: TransparentPtrType> FromGlibContainer<<T as GlibPtrDefault>::GlibType, *const GList> for List<T>

unsafe fn from_glib_none_num(ptr: *const GList, _num: usize) -> Self

Transfer: none.

unsafe fn from_glib_container_num(_ptr: *const GList, _num: usize) -> Self

Transfer: container.

unsafe fn from_glib_full_num(_ptr: *const GList, _num: usize) -> Self

Transfer: full.

impl<T: TransparentPtrType> FromGlibContainer<<T as GlibPtrDefault>::GlibType, *mut GList> for List<T>

unsafe fn from_glib_none_num(ptr: *mut GList, _num: usize) -> Self

Transfer: none.

unsafe fn from_glib_container_num(ptr: *mut GList, _num: usize) -> Self

Transfer: container.

unsafe fn from_glib_full_num(ptr: *mut GList, _num: usize) -> Self

Transfer: full.

impl<T: TransparentPtrType> FromGlibPtrContainer<<T as GlibPtrDefault>::GlibType, *const GList> for List<T>

unsafe fn from_glib_none(ptr: *const GList) -> Self

Transfer: none.

unsafe fn from_glib_container(_ptr: *const GList) -> Self

Transfer: container.

unsafe fn from_glib_full(_ptr: *const GList) -> Self

Transfer: full.

impl<T: TransparentPtrType> FromGlibPtrContainer<<T as GlibPtrDefault>::GlibType, *mut GList> for List<T>

unsafe fn from_glib_none(ptr: *mut GList) -> Self

Transfer: none.

unsafe fn from_glib_container(ptr: *mut GList) -> Self

Transfer: container.

unsafe fn from_glib_full(ptr: *mut GList) -> Self

Transfer: full.

impl<T: TransparentPtrType> FromIterator<T> for List<T>

fn from_iter<I: IntoIterator<Item = T>>(iter: I) -> Self

Creates a value from an iterator.

impl<T: TransparentPtrType> IntoGlibPtr<*mut GList> for List<T>

unsafe fn into_glib_ptr(self) -> *mut GList

Transfer: full.

impl<'a, T: TransparentPtrType> IntoIterator for &'a List<T>

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) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, T: TransparentPtrType> IntoIterator for &'a mut List<T>

type Item = &'a mut T

The type of the elements being iterated over.

type IntoIter = IterMut<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T: TransparentPtrType> IntoIterator for List<T>

type Item = T

The type of the elements being iterated over.

type IntoIter = IntoIter<T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, T: TransparentPtrType + 'a> ToGlibPtr<'a, *const GList> for List<T>

type Storage = PhantomData<&'a List<T>>

fn to_glib_none(&'a self) -> Stash<'a, *const GList, Self>

Transfer: none.

fn to_glib_container(&'a self) -> Stash<'a, P, Self>

Transfer: container.

fn to_glib_full(&self) -> P

Transfer: full.

impl<'a, T: TransparentPtrType + 'a> ToGlibPtr<'a, *mut GList> for List<T>

type Storage = PhantomData<&'a List<T>>

fn to_glib_none(&'a self) -> Stash<'a, *mut GList, Self>

Transfer: none.

fn to_glib_container(&'a self) -> Stash<'a, *mut GList, Self>

Transfer: container.

fn to_glib_full(&self) -> *mut GList

Transfer: full.

impl<'a, T: TransparentPtrType + 'a> ToGlibPtrMut<'a, *mut GList> for List<T>

type Storage = PhantomData<&'a mut List<T>>

fn to_glib_none_mut(&'a mut self) -> StashMut<'a, *mut GList, Self>

Transfer: none.

impl<T: Send + TransparentPtrType> Send for List<T>

impl<T: Sync + TransparentPtrType> Sync for List<T>