array__ops 1.0.3

A selection of useful array operations
Documentation 
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

use core::pin::Pin;

use array_trait::Array;
use slice_ops::AsSlice;

use crate::private;

#[const_trait]
pub trait ArrayFromItem<T>: Array<LENGTH = 1> + AsSlice<Item = T>
{
    fn from_item(value: T) -> Self;
    fn from_item_ref(value: &T) -> &Self;
    fn from_item_mut(value: &mut T) -> &mut Self;
    fn from_item_pin_ref(value: Pin<&T>) -> Pin<&Self>;
    fn from_item_pin_mut(value: Pin<&mut T>) -> Pin<&mut Self>;

    fn into_item(self) -> T;
    fn as_item(&self) -> &T;
    fn as_item_mut(&mut self) -> &mut T;
    fn as_item_pin(self: Pin<&Self>) -> Pin<&T>;
    fn as_item_pin_mut(self: Pin<&mut Self>) -> Pin<&mut T>;
}

impl<T> const ArrayFromItem<T> for [T; 1]
{
    fn from_item(value: T) -> Self
    {
        [value]
    }
    fn from_item_ref(value: &T) -> &Self
    {
        core::array::from_ref(value)
    }
    fn from_item_mut(value: &mut T) -> &mut Self
    {
        core::array::from_mut(value)
    }
    fn from_item_pin_ref(value: Pin<&T>) -> Pin<&Self>
    {
        unsafe {
            Pin::new_unchecked(core::array::from_ref(value.get_ref()))
        }
    }
    fn from_item_pin_mut(value: Pin<&mut T>) -> Pin<&mut Self>
    {
        unsafe {
            Pin::new_unchecked(core::array::from_mut(value.get_unchecked_mut()))
        }
    }

    fn into_item(self) -> T
    {
        unsafe {
            private::transmute(self)
        }
    }
    fn as_item(&self) -> &T
    {
        &self[0]
    }
    fn as_item_mut(&mut self) -> &mut T
    {
        &mut self[0]
    }
    fn as_item_pin(self: Pin<&Self>) -> Pin<&T>
    {
        unsafe {
            Pin::new_unchecked(self.get_ref().as_item())
        }
    }
    fn as_item_pin_mut(self: Pin<&mut Self>) -> Pin<&mut T>
    {
        unsafe {
            Pin::new_unchecked(self.get_unchecked_mut().as_item_mut())
        }
    }
}