konst/manually_drop.rs
1//! Const fn equivalents of [`ManuallyDrop<T>`](core::mem::ManuallyDrop) methods.
2
3use core::mem::ManuallyDrop;
4
5/// Const equivalent of `&*manually_drop`
6///
7/// # Example
8///
9/// ```rust
10/// use std::mem::ManuallyDrop;
11/// use konst::manually_drop;
12///
13/// const FOO: &Foo<u64> = &Foo::new(123456);
14/// const FOO_REF: &u64 = FOO.get();
15/// assert_eq!(FOO.get(), &123456);
16/// assert_eq!(FOO_REF, &123456);
17///
18/// const MD: &ManuallyDrop<u64> = &ManuallyDrop::new(654321);
19/// assert_eq!(manually_drop::as_inner(MD), &654321);
20///
21/// pub struct Foo<T>(ManuallyDrop<T>);
22///
23/// impl<T> Foo<T> {
24/// pub const fn new(value: T) -> Self {
25/// Self(ManuallyDrop::new(value))
26/// }
27///
28/// pub const fn get(&self) -> &T {
29/// manually_drop::as_inner(&self.0)
30/// }
31/// }
32/// ```
33#[inline(always)]
34pub const fn as_inner<T>(md: &ManuallyDrop<T>) -> &T {
35 unsafe {
36 crate::utils_1_56::__priv_transmute_ref! {ManuallyDrop<T>, T, md}
37 }
38}
39
40/// Const equivalent of `&mut *manually_drop`
41///
42/// # Example
43///
44/// ```rust
45/// # #![feature(const_mut_refs)]
46/// use std::mem::ManuallyDrop;
47/// use konst::manually_drop;
48///
49/// const fn add_100(num: &mut u32 ) {
50/// *num += 100;
51/// }
52///
53/// const FOO: ManuallyDrop<u32> = {
54/// let mut mu = ManuallyDrop::new(5);
55/// let inner = manually_drop::as_inner_mut(&mut mu);
56/// add_100(inner);
57/// add_100(inner);
58/// add_100(inner);
59/// mu
60/// };
61///
62/// assert_eq!(*FOO, 305);
63/// ```
64#[cfg(feature = "mut_refs")]
65#[cfg_attr(feature = "docsrs", doc(cfg(feature = "mut_refs")))]
66#[inline(always)]
67pub const fn as_inner_mut<T>(md: &mut ManuallyDrop<T>) -> &mut T {
68 unsafe {
69 crate::utils_mut::__priv_transmute_mut! {ManuallyDrop<T>, T, md}
70 }
71}