Function vecshard::merge_shards

Important traits for VecShard<T>

impl<T> Iterator for VecShard<T> type Item = T;

pub fn merge_shards<T>(left: VecShard<T>, right: VecShard<T>) -> VecShard<T>

Merge the given shards into a single shard.

If left and right are from the same Vec and directly adjacent with the end of left directly touching the start of right, this will work in O(1) time. Otherwise, it will need to copy things around and possibly allocate a new Vec