#![no_std] #![feature(asm)] extern crate bit_field; use bit_field::BitField; use core::ops::Range; /// Allocator of a bitmap, able to allocate / free bits. /// /// CAP: the bitmap has a total of CAP bits, numbered from 0 to CAP-1 inclusively. /// /// alloc: allocate a free bit. /// dealloc: free an allocated bit. /// /// insert: mark bits in the range as allocated (available) /// remove: reverse of insert /// /// any: whether there are free bits remaining /// test: whether a specific bit is free pub trait BitAlloc: Default { const CAP: usize; fn alloc(&mut self) -> Option; fn dealloc(&mut self, key: usize); fn insert(&mut self, range: Range); fn remove(&mut self, range: Range); fn any(&self) -> bool; fn test(&self, key: usize) -> bool; } pub type BitAlloc256 = BitAllocCascade16; pub type BitAlloc4K = BitAllocCascade16; pub type BitAlloc64K = BitAllocCascade16; pub type BitAlloc1M = BitAllocCascade16; pub type BitAlloc16M = BitAllocCascade16; pub type BitAlloc256M = BitAllocCascade16; /// Implement the bit allocator by segment tree algorithm. #[derive(Default)] pub struct BitAllocCascade16 { bitset: u16, // for each bit, 1 indicates available, 0 indicates inavailable sub: [T; 16], } impl BitAlloc for BitAllocCascade16 { const CAP: usize = T::CAP * 16; fn alloc(&mut self) -> Option { if self.any() { let i = log2(self.bitset); let res = self.sub[i].alloc().unwrap() + i * T::CAP; self.bitset.set_bit(i, self.sub[i].any()); Some(res) } else { None } } fn dealloc(&mut self, key: usize) { let i = key / T::CAP; self.sub[i].dealloc(key % T::CAP); self.bitset.set_bit(i, true); } fn insert(&mut self, range: Range) { self.for_range(range, |sub: &mut T, range| sub.insert(range)); } fn remove(&mut self, range: Range) { self.for_range(range, |sub: &mut T, range| sub.remove(range)); } fn any(&self) -> bool { self.bitset != 0 } fn test(&self, key: usize) -> bool { self.sub[key / T::CAP].test(key % T::CAP) } } impl BitAllocCascade16 { fn for_range(&mut self, range: Range, f: impl Fn(&mut T, Range)) { let Range { start, end } = range; assert!(end <= Self::CAP); for i in start / T::CAP..=(end - 1) / T::CAP { let begin = if start / T::CAP == i { start % T::CAP } else { 0 }; let end = if end / T::CAP == i { end % T::CAP } else { T::CAP }; f(&mut self.sub[i], begin..end); self.bitset.set_bit(i, self.sub[i].any()); } } } #[derive(Default)] pub struct BitAlloc16(u16); /// BitAlloc16 acts as the leaf (except the leaf bits of course) nodes /// in the segment trees. impl BitAlloc for BitAlloc16 { const CAP: usize = 16; fn alloc(&mut self) -> Option { if self.any() { let i = log2(self.0); self.0.set_bit(i, false); Some(i) } else { None } } fn dealloc(&mut self, key: usize) { assert!(!self.test(key)); self.0.set_bit(key, true); } fn insert(&mut self, range: Range) { self.0.set_bits(range.clone(), 0xffff.get_bits(range)); } fn remove(&mut self, range: Range) { self.0.set_bits(range, 0); } fn any(&self) -> bool { self.0 != 0 } fn test(&self, key: usize) -> bool { self.0.get_bit(key) } } #[inline(always)] #[cfg(target_arch = "x86_64")] fn log2(x: u16) -> usize { assert_ne!(x, 0); let pos: u16; unsafe { asm!("bsrw $1, $0" :"=r"(pos) :"r"(x) : :"volatile") }; pos as usize } #[inline(always)] #[cfg(not(target_arch = "x86_64"))] fn log2(x: u16) -> usize { log2_naive(x) } #[inline(always)] fn log2_naive(mut x: u16) -> usize { assert_ne!(x, 0); let mut pos = -1; while x != 0 { pos += 1; x >>= 1; } pos as usize } #[cfg(test)] mod tests { use super::*; #[test] fn log2_() { for x in 1..=0xffff { assert_eq!(log2(x), log2_naive(x), "log2 failed: {}", x); } } #[test] fn bitalloc16() { let mut ba = BitAlloc16::default(); assert_eq!(BitAlloc16::CAP, 16); ba.insert(0..16); for i in 0..16 { assert_eq!(ba.test(i), true); } ba.remove(8..14); assert_eq!(ba.alloc(), Some(15)); assert_eq!(ba.alloc(), Some(14)); assert_eq!(ba.alloc(), Some(7)); ba.dealloc(14); ba.dealloc(15); ba.dealloc(7); for _ in 0..10 { assert!(ba.alloc().is_some()); } assert!(!ba.any()); assert!(ba.alloc().is_none()); } #[test] fn bitalloc4k() { let mut ba = BitAlloc4K::default(); assert_eq!(BitAlloc4K::CAP, 4096); ba.insert(0..4096); for i in 0..4096 { assert_eq!(ba.test(i), true); } ba.remove(8..4094); for i in 0..4096 { assert_eq!(ba.test(i), i < 8 || i >= 4094); } assert_eq!(ba.alloc(), Some(4095)); assert_eq!(ba.alloc(), Some(4094)); assert_eq!(ba.alloc(), Some(7)); ba.dealloc(4095); ba.dealloc(4094); ba.dealloc(7); for _ in 0..10 { assert!(ba.alloc().is_some()); } assert!(ba.alloc().is_none()); } }