4444//!
4545//! A number of traits add methods that allow you to accomplish tasks with slices.
4646//! These traits include `ImmutableSlice`, which is defined for `&[T]` types,
47- //! and `MutableSlice`, defined for `&mut [T]` types.
47+ //! `MutableSlice`, defined for `&mut [T]` types, and `Slice` and `SliceMut`
48+ //! which are defined for `[T]`.
4849//!
49- //! An example is the method `.slice(a, b)` that returns an immutable "view" into
50- //! a `Vec` or another slice from the index interval `[a, b)`:
50+ //! An example is the `slice` method which enables slicing syntax `[a..b]` that
51+ //! returns an immutable "view" into a `Vec` or another slice from the index
52+ //! interval `[a, b)`:
5153//!
5254//! ```rust
53- //! let numbers = [0i, 1i, 2i];
54- //! let last_numbers = numbers.slice(1, 3);
55- //! // last_numbers is now &[1i, 2i]
55+ //! #![feature(slicing_syntax)]
56+ //! fn main() {
57+ //! let numbers = [0i, 1i, 2i];
58+ //! let last_numbers = numbers[1..3];
59+ //! // last_numbers is now &[1i, 2i]
60+ //! }
5661//! ```
5762//!
5863//! ## Implementations of other traits
@@ -93,7 +98,7 @@ use core::iter::{range_step, MultiplicativeIterator};
9398use MutableSeq ;
9499use vec:: Vec ;
95100
96- pub use core:: slice:: { Chunks , Slice , ImmutableSlice , ImmutablePartialEqSlice } ;
101+ pub use core:: slice:: { Chunks , AsSlice , ImmutableSlice , ImmutablePartialEqSlice } ;
97102pub use core:: slice:: { ImmutableOrdSlice , MutableSlice , Items , MutItems } ;
98103pub use core:: slice:: { MutSplits , MutChunks , Splits } ;
99104pub use core:: slice:: { bytes, mut_ref_slice, ref_slice, MutableCloneableSlice } ;
@@ -112,7 +117,7 @@ pub trait VectorVector<T> {
112117 fn connect_vec ( & self , sep : & T ) -> Vec < T > ;
113118}
114119
115- impl < ' a , T : Clone , V : Slice < T > > VectorVector < T > for & ' a [ V ] {
120+ impl < ' a , T : Clone , V : AsSlice < T > > VectorVector < T > for & ' a [ V ] {
116121 fn concat_vec ( & self ) -> Vec < T > {
117122 let size = self . iter ( ) . fold ( 0 u, |acc, v| acc + v. as_slice ( ) . len ( ) ) ;
118123 let mut result = Vec :: with_capacity ( size) ;
@@ -610,7 +615,7 @@ impl<'a,T> MutableSliceAllocating<'a, T> for &'a mut [T] {
610615
611616 #[ inline]
612617 fn move_from ( self , mut src : Vec < T > , start : uint , end : uint ) -> uint {
613- for ( a, b) in self . iter_mut ( ) . zip ( src. slice_mut ( start , end) . iter_mut ( ) ) {
618+ for ( a, b) in self . iter_mut ( ) . zip ( src[ mut start.. end] . iter_mut ( ) ) {
614619 mem:: swap ( a, b) ;
615620 }
616621 cmp:: min ( self . len ( ) , end-start)
@@ -702,7 +707,7 @@ impl<'a, T: Ord> MutableOrdSlice<T> for &'a mut [T] {
702707 self . swap ( j, i-1 ) ;
703708
704709 // Step 4: Reverse the (previously) weakly decreasing part
705- self . slice_from_mut ( i ) . reverse ( ) ;
710+ self [ mut i.. ] . reverse ( ) ;
706711
707712 true
708713 }
@@ -723,7 +728,7 @@ impl<'a, T: Ord> MutableOrdSlice<T> for &'a mut [T] {
723728 }
724729
725730 // Step 2: Reverse the weakly increasing part
726- self . slice_from_mut ( i ) . reverse ( ) ;
731+ self [ mut i.. ] . reverse ( ) ;
727732
728733 // Step 3: Find the rightmost element equal to or bigger than the pivot (i-1)
729734 let mut j = self . len ( ) - 1 ;
@@ -990,24 +995,24 @@ mod tests {
990995 fn test_slice ( ) {
991996 // Test fixed length vector.
992997 let vec_fixed = [ 1 i, 2 , 3 , 4 ] ;
993- let v_a = vec_fixed. slice ( 1 u , vec_fixed. len ( ) ) . to_vec ( ) ;
998+ let v_a = vec_fixed[ 1 u.. vec_fixed. len ( ) ] . to_vec ( ) ;
994999 assert_eq ! ( v_a. len( ) , 3 u) ;
9951000 let v_a = v_a. as_slice ( ) ;
9961001 assert_eq ! ( v_a[ 0 ] , 2 ) ;
9971002 assert_eq ! ( v_a[ 1 ] , 3 ) ;
9981003 assert_eq ! ( v_a[ 2 ] , 4 ) ;
9991004
10001005 // Test on stack.
1001- let vec_stack = & [ 1 i, 2 , 3 ] ;
1002- let v_b = vec_stack. slice ( 1 u , 3 u ) . to_vec ( ) ;
1006+ let vec_stack: & [ _ ] = & [ 1 i, 2 , 3 ] ;
1007+ let v_b = vec_stack[ 1 u.. 3 u ] . to_vec ( ) ;
10031008 assert_eq ! ( v_b. len( ) , 2 u) ;
10041009 let v_b = v_b. as_slice ( ) ;
10051010 assert_eq ! ( v_b[ 0 ] , 2 ) ;
10061011 assert_eq ! ( v_b[ 1 ] , 3 ) ;
10071012
10081013 // Test `Box<[T]>`
10091014 let vec_unique = vec ! [ 1 i, 2 , 3 , 4 , 5 , 6 ] ;
1010- let v_d = vec_unique. slice ( 1 u , 6 u ) . to_vec ( ) ;
1015+ let v_d = vec_unique[ 1 u.. 6 u ] . to_vec ( ) ;
10111016 assert_eq ! ( v_d. len( ) , 5 u) ;
10121017 let v_d = v_d. as_slice ( ) ;
10131018 assert_eq ! ( v_d[ 0 ] , 2 ) ;
@@ -1020,21 +1025,21 @@ mod tests {
10201025 #[ test]
10211026 fn test_slice_from ( ) {
10221027 let vec: & [ int ] = & [ 1 , 2 , 3 , 4 ] ;
1023- assert_eq ! ( vec. slice_from ( 0 ) , vec) ;
1028+ assert_eq ! ( vec[ 0 .. ] , vec) ;
10241029 let b: & [ int ] = & [ 3 , 4 ] ;
1025- assert_eq ! ( vec. slice_from ( 2 ) , b) ;
1030+ assert_eq ! ( vec[ 2 .. ] , b) ;
10261031 let b: & [ int ] = & [ ] ;
1027- assert_eq ! ( vec. slice_from ( 4 ) , b) ;
1032+ assert_eq ! ( vec[ 4 .. ] , b) ;
10281033 }
10291034
10301035 #[ test]
10311036 fn test_slice_to ( ) {
10321037 let vec: & [ int ] = & [ 1 , 2 , 3 , 4 ] ;
1033- assert_eq ! ( vec. slice_to ( 4 ) , vec) ;
1038+ assert_eq ! ( vec[ .. 4 ] , vec) ;
10341039 let b: & [ int ] = & [ 1 , 2 ] ;
1035- assert_eq ! ( vec. slice_to ( 2 ) , b) ;
1040+ assert_eq ! ( vec[ .. 2 ] , b) ;
10361041 let b: & [ int ] = & [ ] ;
1037- assert_eq ! ( vec. slice_to ( 0 ) , b) ;
1042+ assert_eq ! ( vec[ .. 0 ] , b) ;
10381043 }
10391044
10401045
@@ -1975,7 +1980,7 @@ mod tests {
19751980 assert ! ( a == [ 7 i, 2 , 3 , 4 ] ) ;
19761981 let mut a = [ 1 i, 2 , 3 , 4 , 5 ] ;
19771982 let b = vec ! [ 5 i, 6 , 7 , 8 , 9 , 0 ] ;
1978- assert_eq ! ( a. slice_mut ( 2 , 4 ) . move_from( b, 1 , 6 ) , 2 ) ;
1983+ assert_eq ! ( a[ mut 2 .. 4 ] . move_from( b, 1 , 6 ) , 2 ) ;
19791984 assert ! ( a == [ 1 i, 2 , 6 , 7 , 5 ] ) ;
19801985 }
19811986
@@ -1995,7 +2000,7 @@ mod tests {
19952000 #[ test]
19962001 fn test_reverse_part ( ) {
19972002 let mut values = [ 1 i, 2 , 3 , 4 , 5 ] ;
1998- values. slice_mut ( 1 , 4 ) . reverse ( ) ;
2003+ values[ mut 1 .. 4 ] . reverse ( ) ;
19992004 assert ! ( values == [ 1 , 4 , 3 , 2 , 5 ] ) ;
20002005 }
20012006
@@ -2042,9 +2047,9 @@ mod tests {
20422047 fn test_bytes_set_memory ( ) {
20432048 use slice:: bytes:: MutableByteVector ;
20442049 let mut values = [ 1u8 , 2 , 3 , 4 , 5 ] ;
2045- values. slice_mut ( 0 , 5 ) . set_memory ( 0xAB ) ;
2050+ values[ mut 0 .. 5 ] . set_memory ( 0xAB ) ;
20462051 assert ! ( values == [ 0xAB , 0xAB , 0xAB , 0xAB , 0xAB ] ) ;
2047- values. slice_mut ( 2 , 4 ) . set_memory ( 0xFF ) ;
2052+ values[ mut 2 .. 4 ] . set_memory ( 0xFF ) ;
20482053 assert ! ( values == [ 0xAB , 0xAB , 0xFF , 0xFF , 0xAB ] ) ;
20492054 }
20502055
@@ -2070,12 +2075,18 @@ mod tests {
20702075 let mut values = [ 1u8 , 2 , 3 , 4 , 5 ] ;
20712076 {
20722077 let ( left, right) = values. split_at_mut ( 2 ) ;
2073- assert ! ( left. slice( 0 , left. len( ) ) == [ 1 , 2 ] ) ;
2078+ {
2079+ let left: & [ _ ] = left;
2080+ assert ! ( left[ 0 ..left. len( ) ] == [ 1 , 2 ] ) ;
2081+ }
20742082 for p in left. iter_mut ( ) {
20752083 * p += 1 ;
20762084 }
20772085
2078- assert ! ( right. slice( 0 , right. len( ) ) == [ 3 , 4 , 5 ] ) ;
2086+ {
2087+ let right: & [ _ ] = right;
2088+ assert ! ( right[ 0 ..right. len( ) ] == [ 3 , 4 , 5 ] ) ;
2089+ }
20792090 for p in right. iter_mut ( ) {
20802091 * p += 2 ;
20812092 }
@@ -2099,7 +2110,7 @@ mod tests {
20992110 }
21002111 assert_eq ! ( cnt, 3 ) ;
21012112
2102- for f in v. slice ( 1 , 3 ) . iter ( ) {
2113+ for f in v[ 1 .. 3 ] . iter ( ) {
21032114 assert ! ( * f == Foo ) ;
21042115 cnt += 1 ;
21052116 }
0 commit comments