Crate moveslice

This crate contains a single function moveslice. Its purpose is to move a chunk within a slice around. It only uses safe functions, and acts efficiently by using the split_at_mut and rotate_left/ rotate_right functions.

Examples:

use moveslice::moveslice;
 
let mut arr = [1,2,3,4,5,6,7,8,9];
 
// The following moves the slice 3..6 to index 1.
// In effect, it moves [4,5,6] over to where [2] is.
moveslice(&mut arr, (3,6), 1);
assert_eq!(arr, [1,4,5,6,2,3,7,8,9]);
 
// The following moves the slice 3..6 to index 6.
// In effect, it moves [6,2,3] over to where [7] is.
moveslice(&mut arr, (3,6), 6);
assert_eq!(arr, [1,4,5,7,8,9,6,2,3]);
 
// The following attempts to move the slice beyond boundaries.
// The index given is 7, which exists in the array, but the 
// last element of the chunk will not fit (7 + 3 = 10 > 9).
// Therefore, the following should fail.
let result = moveslice(&mut arr, (3,6), 7);
 
// You could pass the destination as the same value as chunk.0.
// However this would mean nothing is moved.
// This doesn't panic, but it's a no-op.
moveslice(&mut arr, (0,3), 0);

Functions

moveslice

Moves a slice around in an array. Works by splitting and rotating.