Struct Vector

pub struct Vector<T>
where
    T: PartialEq + Clone + Debug,
{ /* private fields */ }

A resizable collection of elements that can be randomly accessed and altered.

Implementations

impl<T> Vector<T>

where T: PartialEq + Clone + Debug,

pub fn new() -> Self

Creates a new empty ‘vector’.

pub fn from_vec(v: &Vec<T>) -> Self

Creates a new ‘vector’ that contains the elements in the specified vector.

pub fn with_capacity(capacity: usize) -> Self

Creates a new ‘vector’ with the specified capacity.

pub fn with_length(length: usize, item: &T) -> Self

Creates a new ‘vector’ with the specified length with all values set to the specified value.

Trait Implementations

impl<T> ArrayCollection<T> for Vector<T>

where T: PartialEq + Clone + Debug,

fn get(&self, index: usize) -> Option<&T>

Returns the element at the specified index or None if the index is out-of-bounds.

fn index_list(&self, item: &T) -> Option<Vec<usize>>

Returns a vector of indices that contain the specified element or None if the ‘vector’ doesn’t contain the specified element.

fn index_of(&self, item: &T) -> Option<usize>

Returns the first index of the specified element or None if the ‘vector’ doesn’t contain the specified element.

fn last_index_of(&self, item: &T) -> Option<usize>

Returns the last index of the specified element or None if the ‘vector’ doesn’t contain the specified element.

fn set(&mut self, index: usize, item: &T) -> Option<T>

Sets the element at the specified index to the specified value. Returns the item being replaced at the specified index.

Panics

This function panics if the specified index is out-of-bounds.

fn slice(&mut self, r: Range<usize>) -> Box<[T]>

Returns a ‘slice’ of this ‘vector’ within the specified index ‘range’.

Panics

This function panics if the specified range is out-of-bounds.

impl<T> Clear for Vector<T>

where T: PartialEq + Clone + Debug,

fn clear(&mut self)

Clears all elements from this ‘vector’.

impl<T> Clone for Vector<T>

where T: PartialEq + Clone + Debug,

fn clone(&self) -> Self

Returns a clone of this ‘vector’.

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

Performs copy-assignment from source.

impl<T> Collection for Vector<T>

where T: PartialEq + Clone + Debug,

type Element = T

The element type.

fn capacity(&self) -> usize

Returns the capacity of this ‘vector’.

fn contains(&self, item: &T) -> bool

Returns true if this ‘vector’ contains the specified element.

fn contains_all(&self, vec: &Vec<T>) -> bool

Returns true if this ‘vector’ contains the specified vector.

fn to_vec(&self) -> Vec<T>

Returns a vector containing the elements of this ‘vector’.

impl<T> Debug for Vector<T>

where T: PartialEq + Clone + Debug,

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

Displays the debug information for this ‘vector’.

impl<T> Empty for Vector<T>

where T: PartialEq + Clone + Debug,

fn is_empty(&self) -> bool

Returns true if this ‘vector’ is empty.

impl<T> Index<usize> for Vector<T>

where T: PartialEq + Clone + Debug,

type Output = T

Output type.

fn index(&self, index: usize) -> &Self::Output

Returns the value of this ‘vector’ at the specified index.

Panics

This function panics if the index is out-of-bounds.

impl<T> IndexMut<usize> for Vector<T>

where T: PartialEq + Clone + Debug,

fn index_mut(&mut self, index: usize) -> &mut Self::Output

Returns the value of this ‘vector’ at the specified index.

Panics

This function panics if the index is out-of-bounds.

impl<T> IntoIterator for Vector<T>

where T: PartialEq + Clone + Debug,

type Item = T

The Item type.

type IntoIter = IntoIter<T>

The IntoIter type.

fn into_iter(self) -> Self::IntoIter

Converts this ‘vector’ into an ‘iterator’.

impl<T> Len for Vector<T>

where T: PartialEq + Clone + Debug,

fn len(&self) -> usize

Returns the length of this ‘vector’.

impl<T> ListCollection<T> for Vector<T>

where T: PartialEq + Clone + Debug,

fn append(&mut self, item: T) -> bool

Appends the specified element to the end of the ‘vector’. Returns true if successful.

Panics

This function panics if the new capacity exceeds isize::MAX bytes.

fn append_all(&mut self, vec: Vec<T>) -> bool

Appends the specified vector to the end of the ‘vector’. Returns true if successful.

Panics

This function panics if the new capacity exceeds isize::MAX bytes.

fn insert(&mut self, index: usize, item: T) -> bool

Inserts the specified element at the specified index. Returns true if successful.

Panics

This function panics if the specified index is greater than the ‘vector’s’ length.

fn insert_all(&mut self, index: usize, vec: Vec<T>) -> bool

Inserts the specified vector at the specified index. Returns true if successful.

Panics

This function panics if the specified index is greater than the ‘vector’s’ length.

fn prepend(&mut self, item: T) -> bool

Prepends the specified element to the start of the ‘vector’. Returns true if successful.

fn prepend_all(&mut self, vec: Vec<T>) -> bool

Prepends the specified vector to the start of the ‘vector’. Returns true if successful.

fn remove(&mut self, item: T) -> bool

Removes the last occurrence of the specified element from this ‘vector’. Returns true if the element was removed or false if it was not found.

fn remove_any(&mut self, item: T) -> usize

Removes any occurrence of the specified value from this ‘vector’. Returns the number of occurrences that were removed.

fn remove_all(&mut self, vec: Vec<T>) -> usize

Removes the elements in the specified vector, if they are in this ‘vector’. Returns the number of removed elements. All occurrences of the elements in the specified vector are removed.

fn remove_last(&mut self, item: T) -> bool

Removes the last occurrence of the specified element from this ‘vector’. Returns true if the element was removed or false if it was not found.

fn retain_all(&mut self, vec: Vec<T>) -> usize

Removes all elements from this ‘vector’ that are not in the specified vector. Returns the new size of this ‘vector’ after retaining.

impl<T> PartialEq for Vector<T>

where T: PartialEq + Clone + Debug,

fn eq(&self, other: &Self) -> bool

Returns true if this ‘vector’ and the specified ‘vector’ are equal, meaning they are the same length and contain the same elements.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> Reversible for Vector<T>

where T: PartialEq + Clone + Debug,

fn reverse(&mut self) -> Self

Returns a copy of this ‘vector’ in reverse order.

impl<T> Sortable for Vector<T>

where T: PartialEq + PartialOrd + Clone + Debug,

fn is_sorted(&self) -> bool

Returns true if this ‘vector’ is sorted in ascending order.

fn is_sorted_rev(&self) -> bool

Returns true if this ‘vector’ is sorted in descending order.

fn sort(&mut self)

Sorts the elements in this ‘vector’ in ascending order.

fn sort_rev(&mut self)

Sorts the elements in this ‘vector’ in descending order.

impl<T> VectorCollection<T> for Vector<T>

where T: PartialEq + Clone + Debug,

fn extend(&mut self, additional: usize, item: &T)

Extends the length of this ‘vector’ by the specified additional amount with all new elements set to the specified value.

fn reserve(&mut self, additional: usize)

Reserves capacity for the specified number of additional elements.

Panics

This function panics if the new capacity exceeds isize::MAX bytes.

fn resize(&mut self, length: usize, item: &T)

Resizes the ‘vector’ to the specified length with any new elements set to the specified value.

fn shrink(&mut self)

Sets the capacity to match the current length of this ‘vector’.

fn truncate(&mut self, length: usize)

Truncates the length of this ‘vector’ to the specified length.