Primitive Type slice
[-]
[+]
Utilities for slice manipulation
The slice module contains useful code to help work with slice values.
Slices are a view into a block of memory represented as a pointer and a length.
// slicing a Vec let vec = vec!(1i, 2, 3); let int_slice = vec.as_slice(); // coercing an array to a slice let str_slice: &[&str] = &["one", "two", "three"];
Slices are either mutable or shared. The shared slice type is &[T],
while the mutable slice type is &mut[T]. For example, you can mutate the
block of memory that a mutable slice points to:
let x: &mut[int] = &mut [1i, 2, 3]; x[1] = 7; assert_eq!(x[0], 1); assert_eq!(x[1], 7); assert_eq!(x[2], 3);
Here are some of the things this module contains:
Structs
There are several structs that are useful for slices, such as Items, which
represents iteration over a slice.
Traits
A number of traits add methods that allow you to accomplish tasks
with slices, the most important being SlicePrelude. Other traits
apply only to slices of elements satisfying certain bounds (like
Ord).
An example is the slice method which enables slicing syntax [a..b] that
returns an immutable "view" into a Vec or another slice from the index
interval [a, b):
#![feature(slicing_syntax)] fn main() { let numbers = [0i, 1i, 2i]; let last_numbers = numbers[1..3]; // last_numbers is now &[1i, 2i] }
Implementations of other traits
There are several implementations of common traits for slices. Some examples include:
CloneEq,Ord- for immutable slices whose element type areEqorOrd.Hash- for slices whose element type isHash
Iteration
The method iter() returns an iteration value for a slice. The iterator
yields references to the slice's elements, so if the element
type of the slice is int, the element type of the iterator is &int.
let numbers = [0i, 1i, 2i]; for &x in numbers.iter() { println!("{} is a number!", x); }
.iter_mut()returns an iterator that allows modifying each value.- Further iterators exist that split, chunk or permute the slice.
Trait Implementations
impl<'a, T: Clone, V: AsSlice<T>> VectorVector<T> for [V]
fn concat_vec(&self) -> Vec<T>
fn connect_vec(&self, sep: &T) -> Vec<T>
impl<T: Clone> CloneSliceAllocPrelude<T> for [T]
fn to_vec(&self) -> Vec<T>
Returns a copy of v.
fn partitioned(&self, f: |&T| -> bool) -> (Vec<T>, Vec<T>)
fn permutations(&self) -> Permutations<T>
Returns an iterator over all permutations of a vector.