ring/polyfill/slice.rs
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57
// Permission is hereby granted, free of charge, to any
// person obtaining a copy of this software and associated
// documentation files (the "Software"), to deal in the
// Software without restriction, including without
// limitation the rights to use, copy, modify, merge,
// publish, distribute, sublicense, and/or sell copies of
// the Software, and to permit persons to whom the Software
// is furnished to do so, subject to the following
// conditions:
//
// The above copyright notice and this permission notice
// shall be included in all copies or substantial portions
// of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
// ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
// TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
// PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
// SHALL THE AUTHOR OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
// IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.
mod as_chunks;
mod as_chunks_mut;
pub use as_chunks::{as_chunks, AsChunks};
pub use as_chunks_mut::{as_chunks_mut, AsChunksMut};
// TODO(MSRV feature(split_at_checked)): Use `slice::split_at_checked`.
//
// Note that the libcore version is implemented in terms of
// `slice::split_at_unchecked()`, and `slice::split_at()` was changed to be
// implemented in terms of `split_at_checked`. For now, we implement this in
// terms of `split_at` and rely on the optimizer to eliminate the panic.
#[inline(always)]
pub fn split_at_checked<T>(slice: &[T], i: usize) -> Option<(&[T], &[T])> {
if slice.len() >= i {
Some(slice.split_at(i))
} else {
None
}
}
// TODO(MSRV-1.77): Use `slice::split_first_chunk_mut`.
#[inline(always)]
pub fn split_first_chunk_mut<T, const N: usize>(
slice: &mut [T],
) -> Option<(&mut [T; N], &mut [T])> {
if slice.len() >= N {
let (head, tail) = slice.split_at_mut(N);
head.try_into().ok().map(|head| (head, tail))
} else {
None
}
}