SafeManuallyDrop 1.0.3

A safe version of ManuallyDrop with various features and options to track undefined behavior when working with ManuallyDrop.
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


//! A safe version of the insecure manual control of freeing memory.

use crate::UnsafeStdManuallyDrop;
use crate::core::trig::TrigManuallyDrop;
use core::marker::PhantomData;

/// A safe version of the insecure manual control of freeing memory.
// #[repr(transparent)]
pub struct SafeManuallyDrop<T, Trig> where T: ?Sized, Trig: TrigManuallyDrop {
	state: StateManuallyDrop,
	_pp: PhantomData<Trig>,
	
	value: UnsafeStdManuallyDrop<T>,
}

crate::__codegen! {
	@use;
	@impl SafeManuallyDrop {
		is_safe: true,
		is_always_compatible: false,
		is_maybe_compatible: true,
		is_repr_transparent: false,
		
		fn {
			/// Wrap a value to be manually dropped.
			new |value| {
				Self {
					value,
					state: /*StateManuallyDrop::empty()*/ EMPTY_STATE,
					_pp: PhantomData
				}
			}
			
			as_unsafestd_manuallydrop |sself| {
				&sself.value
			}
			
			as_mut_unsafestd_manuallydrop |sself| {
				&mut sself.value
			}
			
			/// Get reference to value. Always unprotected!
			force_as_value |sself| {
				&sself.value
			}
			
			/// Get a mutable reference to a value. Always unprotected!
			force_as_mut_value |sself| {
				&mut sself.value
			}
		}
	}
}

//impl<T> Copy for ManuallyDrop<T> where T: ?Sized + Copy {} TODO

impl<T, Trig> Drop for SafeManuallyDrop<T, Trig> where T: ?Sized, Trig: TrigManuallyDrop {
	#[inline]
	fn drop(&mut self) {
		self.state.if_empty_then_run_trigfn::<Trig, _>(
			"expected ManuallyDrop::drop(&mut value)",
			|| unsafe {
				// What for? - >> to ignore miri errors allocate.
				UnsafeStdManuallyDrop::drop(&mut self.value);
			}
		);
	}
}