ref_slice 1.2.1

Turn a reference into a slice of length one.
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

#![no_std]

pub use self::opt_slice_mut as mut_opt_slice;

#[allow(deprecated)]
pub use self::ref_slice_mut as mut_ref_slice;

/// Converts a reference to `A` into a slice of length 1 (without copying).
#[inline]
#[deprecated = "Similar method was added to std and stabilized in rust 1.28.0. \
                Use `core::slice::from_ref` instead."]
pub fn ref_slice<A>(s: &A) -> &[A] {
    unsafe { core::slice::from_raw_parts(s, 1) }
}

/// Converts a reference to `A` into a slice of length 1 (without copying).
#[inline]
#[deprecated = "Similar method was added to std and stabilized in rust 1.28.0. \
                Use `core::slice::from_mut` instead."]
pub fn ref_slice_mut<A>(s: &mut A) -> &mut [A] {
    unsafe { core::slice::from_raw_parts_mut(s, 1) }
}

/// Converts a reference to `Option<A>` into a slice of length 0 or 1 (without copying).
#[inline]
pub fn opt_slice<A>(opt: &Option<A>) -> &[A] {
    match *opt {
        #[allow(deprecated)]
        Some(ref val) => ref_slice(val),
        None => &[],
    }
}

/// Converts a reference to `Option<A>` into a slice of length 0 or 1 (without copying).
#[inline]
pub fn opt_slice_mut<A>(opt: &mut Option<A>) -> &mut [A] {
    match *opt {
        #[allow(deprecated)]
        Some(ref mut val) => mut_ref_slice(val),
        None => &mut [],
    }
}

#[cfg(test)]
#[allow(deprecated)]
mod tests {
    use super::mut_opt_slice;
    use super::mut_ref_slice;
    use super::opt_slice;
    use super::ref_slice;

    #[test]
    fn check() {
        let x = &5;
        let xs = ref_slice(x);

        let result: &[i32] = &[5];

        assert_eq!(result, xs);
    }

    #[test]
    fn check_mut() {
        let x = &mut 5;
        let xs = mut_ref_slice(x);

        let result: &mut [i32] = &mut [5];

        assert_eq!(result, xs);
    }

    #[test]
    fn check_opt() {
        let x = &Some(42);
        let n = &None;
        let xs = opt_slice(x);
        let ns = opt_slice(n);

        let result_x: &[i32] = &[42];
        let result_n: &[i32] = &[];

        assert_eq!(result_x, xs);
        assert_eq!(result_n, ns);
    }

    #[test]
    fn check_opt_mut() {
        let x = &mut Some(42);
        let n = &mut None;
        let xs = mut_opt_slice(x);
        let ns = mut_opt_slice(n);

        let result_x: &[i32] = &mut [42];
        let result_n: &[i32] = &mut [];

        assert_eq!(result_x, xs);
        assert_eq!(result_n, ns);
    }
}