cluStaticData 1.2.0

Initializers of static values. Manual initialization, automatic initialization.
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126




#[doc(hidden)]
#[macro_export]
macro_rules! once_runtime_data {
	[$(#[$($mt:tt)*])* static ref +runtime $name:ident: $t: ty = $a:expr; $($tt:tt)*] => {
		#[allow(non_snake_case)]
		#[doc(hidden)]
		mod $name {
			use super::*;
			$crate::new_lazy_struct! {
				$(#[$($mt)*])*
				pub(crate) _HIDDEN : $t = $a;
			}
		}
		
		$(#[$($mt)*])*
		static $name: $name::_HIDDEN = $name::_HIDDEN::new();
		
		$crate::once_runtime_data! {
			$($tt)*
		}
	};
	
	[$(#[$($mt:tt)*])* pub $(($($at:tt)*))* static ref +runtime $name:ident: $t: ty = $a:expr; $($tt:tt)*] => {
		#[allow(non_snake_case)]
		#[doc(hidden)]
		mod $name {
			use super::*;
			$crate::new_lazy_struct! {
				$(#[$($mt)*])*
				pub(crate) _HIDDEN : $t = $a;
			}
		}
		
		$(#[$($mt)*])*
		pub $(($($at)*))* static $name: $name::_HIDDEN = $name::_HIDDEN::new();
		
		$crate::once_runtime_data! {
			$($tt)*
		}
	};
	
	() => ()
}



#[doc(hidden)]
#[macro_export]
macro_rules! new_lazy_struct {
	[
		$(#[$($mt:tt)*])*
		pub $(($($at:tt)*))*  $name:ident : $t: ty = $b:expr;
	] => {
		#[doc(hidden)]
		#[allow(missing_copy_implementations)]
		#[allow(non_camel_case_types)]
		#[allow(dead_code)]
		$(#[$($mt)*])*
		pub $(($($at)*))* struct $name($crate::once_runtime::Once<$t>);

		impl $name {
			#[doc(hidden)]
			#[inline]
			pub const fn new() -> Self {
				$name($crate::once_runtime::Once::INIT)
			}
			
			#[inline(always)]
			pub fn get<'a>(&'a self) -> &'a $t {
				&**self
			}
		}
		
		
		impl<'a> $crate::once_runtime::generic::InitializeRuntimeStaticData<'a, $t> for $name {
			fn initialize(&'a self) -> &'a $t {
				#[inline(always)]
				fn closure() -> $t {
					$b
				}
				
				self.0.call_once(closure)
			}
		}
		
		impl core::ops::Deref for $name {
			type Target = $t;
			
			#[inline(always)]
			fn deref(&self) -> &Self::Target {
				<$crate::once_runtime::generic::InitializeRuntimeStaticData<$t>>::initialize(self)
			}
		}
		
		impl core::convert::AsRef<$t> for $name {
			#[inline(always)]
			fn as_ref(&self) -> &$t {
				self.get()
			}
		}
		
		impl core::fmt::Debug for $name
			where <Self as core::ops::Deref>::Target:	core::fmt::Debug 
			{
				
			#[inline(always)]
			fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result {
				core::fmt::Debug::fmt(self.get(), f)
			}
		}
		
		#[cfg(feature = "nightly")]
		impl core::fmt::Display for $name
			where <Self as core::ops::Deref>::Target:	core::fmt::Display 
			{
			
			#[inline(always)]
			fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result {
				core::fmt::Display::fmt(self.get(), f)
			}
		}
	};
}