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- //! `MutableSlice`, defined for `&mut [T]` types, and `Slice` and `SliceMut`
48- //! which are defined for `[T]`.
47+ //! and `MutableSlice`, defined for `&mut [T]` types.
4948//!
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)`:
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)`:
5351//!
5452//! ```rust
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- //! }
53+ //! let numbers = [0i, 1i, 2i];
54+ //! let last_numbers = numbers.slice(1, 3);
55+ //! // last_numbers is now &[1i, 2i]
6156//! ```
6257//!
6358//! ## Implementations of other traits
@@ -615,7 +610,7 @@ impl<'a,T> MutableSliceAllocating<'a, T> for &'a mut [T] {
615610
616611 #[ inline]
617612 fn move_from ( self , mut src : Vec < T > , start : uint , end : uint ) -> uint {
618- for ( a, b) in self . iter_mut ( ) . zip ( src[ mut start.. end] . iter_mut ( ) ) {
613+ for ( a, b) in self . iter_mut ( ) . zip ( src. slice_mut ( start , end) . iter_mut ( ) ) {
619614 mem:: swap ( a, b) ;
620615 }
621616 cmp:: min ( self . len ( ) , end-start)
@@ -707,7 +702,7 @@ impl<'a, T: Ord> MutableOrdSlice<T> for &'a mut [T] {
707702 self . swap ( j, i-1 ) ;
708703
709704 // Step 4: Reverse the (previously) weakly decreasing part
710- self [ mut i.. ] . reverse ( ) ;
705+ self . slice_from_mut ( i ) . reverse ( ) ;
711706
712707 true
713708 }
@@ -728,7 +723,7 @@ impl<'a, T: Ord> MutableOrdSlice<T> for &'a mut [T] {
728723 }
729724
730725 // Step 2: Reverse the weakly increasing part
731- self [ mut i.. ] . reverse ( ) ;
726+ self . slice_from_mut ( i ) . reverse ( ) ;
732727
733728 // Step 3: Find the rightmost element equal to or bigger than the pivot (i-1)
734729 let mut j = self . len ( ) - 1 ;
@@ -995,24 +990,24 @@ mod tests {
995990 fn test_slice ( ) {
996991 // Test fixed length vector.
997992 let vec_fixed = [ 1 i, 2 , 3 , 4 ] ;
998- let v_a = vec_fixed[ 1 u.. vec_fixed. len ( ) ] . to_vec ( ) ;
993+ let v_a = vec_fixed. slice ( 1 u , vec_fixed. len ( ) ) . to_vec ( ) ;
999994 assert_eq ! ( v_a. len( ) , 3 u) ;
1000995 let v_a = v_a. as_slice ( ) ;
1001996 assert_eq ! ( v_a[ 0 ] , 2 ) ;
1002997 assert_eq ! ( v_a[ 1 ] , 3 ) ;
1003998 assert_eq ! ( v_a[ 2 ] , 4 ) ;
1004999
10051000 // Test on stack.
1006- let vec_stack: & [ _ ] = & [ 1 i, 2 , 3 ] ;
1007- let v_b = vec_stack[ 1 u.. 3 u ] . to_vec ( ) ;
1001+ let vec_stack = & [ 1 i, 2 , 3 ] ;
1002+ let v_b = vec_stack. slice ( 1 u , 3 u ) . to_vec ( ) ;
10081003 assert_eq ! ( v_b. len( ) , 2 u) ;
10091004 let v_b = v_b. as_slice ( ) ;
10101005 assert_eq ! ( v_b[ 0 ] , 2 ) ;
10111006 assert_eq ! ( v_b[ 1 ] , 3 ) ;
10121007
10131008 // Test `Box<[T]>`
10141009 let vec_unique = vec ! [ 1 i, 2 , 3 , 4 , 5 , 6 ] ;
1015- let v_d = vec_unique[ 1 u.. 6 u ] . to_vec ( ) ;
1010+ let v_d = vec_unique. slice ( 1 u , 6 u ) . to_vec ( ) ;
10161011 assert_eq ! ( v_d. len( ) , 5 u) ;
10171012 let v_d = v_d. as_slice ( ) ;
10181013 assert_eq ! ( v_d[ 0 ] , 2 ) ;
@@ -1025,21 +1020,21 @@ mod tests {
10251020 #[ test]
10261021 fn test_slice_from ( ) {
10271022 let vec: & [ int ] = & [ 1 , 2 , 3 , 4 ] ;
1028- assert_eq ! ( vec[ 0 .. ] , vec) ;
1023+ assert_eq ! ( vec. slice_from ( 0 ) , vec) ;
10291024 let b: & [ int ] = & [ 3 , 4 ] ;
1030- assert_eq ! ( vec[ 2 .. ] , b) ;
1025+ assert_eq ! ( vec. slice_from ( 2 ) , b) ;
10311026 let b: & [ int ] = & [ ] ;
1032- assert_eq ! ( vec[ 4 .. ] , b) ;
1027+ assert_eq ! ( vec. slice_from ( 4 ) , b) ;
10331028 }
10341029
10351030 #[ test]
10361031 fn test_slice_to ( ) {
10371032 let vec: & [ int ] = & [ 1 , 2 , 3 , 4 ] ;
1038- assert_eq ! ( vec[ .. 4 ] , vec) ;
1033+ assert_eq ! ( vec. slice_to ( 4 ) , vec) ;
10391034 let b: & [ int ] = & [ 1 , 2 ] ;
1040- assert_eq ! ( vec[ .. 2 ] , b) ;
1035+ assert_eq ! ( vec. slice_to ( 2 ) , b) ;
10411036 let b: & [ int ] = & [ ] ;
1042- assert_eq ! ( vec[ .. 0 ] , b) ;
1037+ assert_eq ! ( vec. slice_to ( 0 ) , b) ;
10431038 }
10441039
10451040
@@ -1980,7 +1975,7 @@ mod tests {
19801975 assert ! ( a == [ 7 i, 2 , 3 , 4 ] ) ;
19811976 let mut a = [ 1 i, 2 , 3 , 4 , 5 ] ;
19821977 let b = vec ! [ 5 i, 6 , 7 , 8 , 9 , 0 ] ;
1983- assert_eq ! ( a[ mut 2 .. 4 ] . move_from( b, 1 , 6 ) , 2 ) ;
1978+ assert_eq ! ( a. slice_mut ( 2 , 4 ) . move_from( b, 1 , 6 ) , 2 ) ;
19841979 assert ! ( a == [ 1 i, 2 , 6 , 7 , 5 ] ) ;
19851980 }
19861981
@@ -2000,7 +1995,7 @@ mod tests {
20001995 #[ test]
20011996 fn test_reverse_part ( ) {
20021997 let mut values = [ 1 i, 2 , 3 , 4 , 5 ] ;
2003- values[ mut 1 .. 4 ] . reverse ( ) ;
1998+ values. slice_mut ( 1 , 4 ) . reverse ( ) ;
20041999 assert ! ( values == [ 1 , 4 , 3 , 2 , 5 ] ) ;
20052000 }
20062001
@@ -2047,9 +2042,9 @@ mod tests {
20472042 fn test_bytes_set_memory ( ) {
20482043 use slice:: bytes:: MutableByteVector ;
20492044 let mut values = [ 1u8 , 2 , 3 , 4 , 5 ] ;
2050- values[ mut 0 .. 5 ] . set_memory ( 0xAB ) ;
2045+ values. slice_mut ( 0 , 5 ) . set_memory ( 0xAB ) ;
20512046 assert ! ( values == [ 0xAB , 0xAB , 0xAB , 0xAB , 0xAB ] ) ;
2052- values[ mut 2 .. 4 ] . set_memory ( 0xFF ) ;
2047+ values. slice_mut ( 2 , 4 ) . set_memory ( 0xFF ) ;
20532048 assert ! ( values == [ 0xAB , 0xAB , 0xFF , 0xFF , 0xAB ] ) ;
20542049 }
20552050
@@ -2075,18 +2070,12 @@ mod tests {
20752070 let mut values = [ 1u8 , 2 , 3 , 4 , 5 ] ;
20762071 {
20772072 let ( left, right) = values. split_at_mut ( 2 ) ;
2078- {
2079- let left: & [ _ ] = left;
2080- assert ! ( left[ 0 ..left. len( ) ] == [ 1 , 2 ] ) ;
2081- }
2073+ assert ! ( left. slice( 0 , left. len( ) ) == [ 1 , 2 ] ) ;
20822074 for p in left. iter_mut ( ) {
20832075 * p += 1 ;
20842076 }
20852077
2086- {
2087- let right: & [ _ ] = right;
2088- assert ! ( right[ 0 ..right. len( ) ] == [ 3 , 4 , 5 ] ) ;
2089- }
2078+ assert ! ( right. slice( 0 , right. len( ) ) == [ 3 , 4 , 5 ] ) ;
20902079 for p in right. iter_mut ( ) {
20912080 * p += 2 ;
20922081 }
@@ -2110,7 +2099,7 @@ mod tests {
21102099 }
21112100 assert_eq ! ( cnt, 3 ) ;
21122101
2113- for f in v[ 1 .. 3 ] . iter ( ) {
2102+ for f in v. slice ( 1 , 3 ) . iter ( ) {
21142103 assert ! ( * f == Foo ) ;
21152104 cnt += 1 ;
21162105 }
0 commit comments