stalloc 0.7.0

Stalloc is a fast first-fit memory allocator that you can use to quickly speed up your Rust programs.
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

/// A ZST with a given alignment. `Align` and `Alignment` are used to ensure that `Block`, and hence
/// `Stalloc`, are aligned to a particular value.
///
/// The definition of `Block` is:
/// ```rs
/// union Block<const B: usize>
/// where
///     Align<B>: Alignment,
/// {
///     header: Header,
///     bytes: [MaybeUninit<u8>; B],
///     _align: Align<B>,
/// }
/// ```
/// This struct and trait are made public to allow you to define your own wrapper around `Stalloc`.
/// For example, `SyncStalloc` is defined as:
///
/// ```rs
/// #[repr(transparent)]
/// pub struct SyncStalloc<const L: usize, const B: usize>(Mutex<UnsafeStalloc<L, B>>)
/// where
///     Align<B>: Alignment;
/// ```
#[derive(Clone, Copy)]
#[repr(transparent)]
pub struct Align<const N: usize>(<Self as Alignment>::Inner)
where
	Self: Alignment;

#[doc(hidden)]
pub trait Alignment {
	/// See the documentation for `Align`.
	type Inner: Copy;
}

macro_rules! impl_alignments {
	($($name:ident as $n:literal),*) => { $(
		#[derive(Copy, Clone)]
		#[repr(align($n))]
		#[doc(hidden)]
		pub struct $name;
		impl Alignment for Align<$n> {
			type Inner = $name;
		}
	)* };
}

impl_alignments!(
	Align1 as 1, Align2 as 2, Align4 as 4, Align8 as 8, Align16 as 16, Align32 as 32,
	Align64 as 64, Align128 as 128, Align256 as 256, Align512 as 512, Align1024 as 1024,
	Align2048 as 2048, Align4096 as 4096, Align8192 as 8192, Align16384 as 16384,
	Align32768 as 32768, Align65536 as 65536, Align131072 as 131_072, Align262144 as 262_144,
	Align524288 as 524_288, Align1048576 as 1_048_576, Align2097152 as 2_097_152,
	Align4194304 as 4_194_304, Align8388608 as 8_388_608, Align16777216 as 16_777_216,
	Align33554432 as 33_554_432, Align67108864 as 67_108_864, Align134217728 as 134_217_728,
	Align268435456 as 268_435_456, Align536870912 as 536_870_912
);