facet-reflect 0.46.0

Build and manipulate values of arbitrary Facet types at runtime while respecting invariants - safe runtime reflection
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

use facet_core::{ResultDef, ResultVTable};

/// Lets you read from a result (implements read-only result operations)
#[derive(Clone, Copy)]
pub struct PeekResult<'mem, 'facet> {
    /// the underlying value
    pub(crate) value: crate::Peek<'mem, 'facet>,

    /// the definition of the result
    pub(crate) def: ResultDef,
}

impl<'mem, 'facet> PeekResult<'mem, 'facet> {
    /// Returns the result definition
    #[inline(always)]
    pub const fn def(self) -> ResultDef {
        self.def
    }

    /// Returns the result vtable
    #[inline(always)]
    pub const fn vtable(self) -> &'static ResultVTable {
        self.def.vtable
    }

    /// Returns whether the result is Ok
    #[inline]
    pub fn is_ok(self) -> bool {
        unsafe { (self.vtable().is_ok)(self.value.data()) }
    }

    /// Returns whether the result is Err
    #[inline]
    pub fn is_err(self) -> bool {
        !self.is_ok()
    }

    /// Returns the Ok value as a Peek if the result is Ok, None otherwise
    #[inline]
    pub fn ok(self) -> Option<crate::Peek<'mem, 'facet>> {
        unsafe {
            let inner_data = (self.vtable().get_ok)(self.value.data());
            if inner_data.is_null() {
                None
            } else {
                Some(crate::Peek::unchecked_new(
                    facet_core::PtrConst::new_sized(inner_data),
                    self.def.t(),
                ))
            }
        }
    }

    /// Returns the Err value as a Peek if the result is Err, None otherwise
    #[inline]
    pub fn err(self) -> Option<crate::Peek<'mem, 'facet>> {
        unsafe {
            let inner_data = (self.vtable().get_err)(self.value.data());
            if inner_data.is_null() {
                None
            } else {
                Some(crate::Peek::unchecked_new(
                    facet_core::PtrConst::new_sized(inner_data),
                    self.def.e(),
                ))
            }
        }
    }
}