Add a macro to make initialization easier

Author: JalonWong

README.md

@@ -31,12 +31,7 @@ static HEAP: Heap = Heap::empty();
 #[entry]
 fn main() -> ! {
     // Initialize the allocator BEFORE you use it
-    {
-        use core::mem::MaybeUninit;
-        const HEAP_SIZE: usize = 1024;
-        static mut HEAP_MEM: [MaybeUninit<u8>; HEAP_SIZE] = [MaybeUninit::uninit(); HEAP_SIZE];
-        unsafe { HEAP.init(&raw mut HEAP_MEM as usize, HEAP_SIZE) }
-    }
+    embedded_alloc::init!(HEAP, 1024);
 
     // now the allocator is ready types like Box, Vec can be used.
 

examples/global_alloc.rs

@@ -17,12 +17,7 @@ static HEAP: Heap = Heap::empty();
 #[entry]
 fn main() -> ! {
     // Initialize the allocator BEFORE you use it
-    {
-        use core::mem::MaybeUninit;
-        const HEAP_SIZE: usize = 1024;
-        static mut HEAP_MEM: [MaybeUninit<u8>; HEAP_SIZE] = [MaybeUninit::uninit(); HEAP_SIZE];
-        unsafe { HEAP.init(&raw mut HEAP_MEM as usize, HEAP_SIZE) }
-    }
+    embedded_alloc::init!(HEAP, 1024);
 
     let mut xs = Vec::new();
     xs.push(1);

src/lib.rs

@@ -12,3 +12,17 @@ mod tlsf;
 pub use llff::Heap as LlffHeap;
 #[cfg(feature = "tlsf")]
 pub use tlsf::Heap as TlsfHeap;
+
+/// Init a heap with a static memory region.
+#[macro_export]
+macro_rules! init {
+    ($heap:ident, $size:expr) => {
+        use core::mem::MaybeUninit;
+        const HEAP_SIZE: usize = $size;
+        static mut HEAP_MEM: [MaybeUninit<u8>; HEAP_SIZE] = [MaybeUninit::uninit(); HEAP_SIZE];
+        #[allow(static_mut_refs)]
+        unsafe {
+            $heap.init(&raw mut HEAP_MEM as usize, HEAP_SIZE)
+        }
+    };
+}