vendor/ena-0.13.1/src/bitvec.rs - toolchain/rustc - Git at Google

 // Copyright 2015 The Rust Project Developers. See the COPYRIGHT
 // file at the top-level directory of this distribution and at
 // http://rust-lang.org/COPYRIGHT.
 //
 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
 // option. This file may not be copied, modified, or distributed
 // except according to those terms.

 /// A very simple BitVector type.
 pub struct BitVector {
     data: Vec<u64>,
 }

 impl BitVector {
     pub fn new(num_bits: usize) -> BitVector {
         let num_words = u64s(num_bits);
         BitVector { data: vec![0; num_words] }
     }

     pub fn contains(&self, bit: usize) -> bool {
         let (word, mask) = word_mask(bit);
         (self.data[word] & mask) != 0
     }

     /// Returns true if the bit has changed.
     pub fn insert(&mut self, bit: usize) -> bool {
         let (word, mask) = word_mask(bit);
         let data = &mut self.data[word];
         let value = *data;
         let new_value = value | mask;
         *data = new_value;
         new_value != value
     }

     pub fn insert_all(&mut self, all: &BitVector) -> bool {
         assert!(self.data.len() == all.data.len());
         let mut changed = false;
         for (i, j) in self.data.iter_mut().zip(&all.data) {
             let value = *i;
             *i = value | *j;
             if value != *i {
                 changed = true;
             }
         }
         changed
     }

     pub fn grow(&mut self, num_bits: usize) {
         let num_words = u64s(num_bits);
         let extra_words = self.data.len() - num_words;
         self.data.extend((0..extra_words).map(|_| 0));
     }

     /// Iterates over indexes of set bits in a sorted order
     pub fn iter<'a>(&'a self) -> BitVectorIter<'a> {
         BitVectorIter {
             iter: self.data.iter(),
             current: 0,
             idx: 0,
         }
     }
 }

 pub struct BitVectorIter<'a> {
     iter: ::std::slice::Iter<'a, u64>,
     current: u64,
     idx: usize,
 }

 impl<'a> Iterator for BitVectorIter<'a> {
     type Item = usize;
     fn next(&mut self) -> Option<usize> {
         while self.current == 0 {
             self.current = if let Some(&i) = self.iter.next() {
                 if i == 0 {
                     self.idx += 64;
                     continue;
                 } else {
                     self.idx = u64s(self.idx) * 64;
                     i
                 }
             } else {
                 return None;
             }
         }
         let offset = self.current.trailing_zeros() as usize;
         self.current >>= offset;
         self.current >>= 1; // shift otherwise overflows for 0b1000_0000_…_0000
         self.idx += offset + 1;
         return Some(self.idx - 1);
     }
 }

 /// A "bit matrix" is basically a square matrix of booleans
 /// represented as one gigantic bitvector. In other words, it is as if
 /// you have N bitvectors, each of length N. Note that `elements` here is `N`/
 #[derive(Clone)]
 pub struct BitMatrix {
     elements: usize,
     vector: Vec<u64>,
 }

 impl BitMatrix {
     // Create a new `elements x elements` matrix, initially empty.
     pub fn new(elements: usize) -> BitMatrix {
         // For every element, we need one bit for every other
         // element. Round up to an even number of u64s.
         let u64s_per_elem = u64s(elements);
         BitMatrix {
             elements: elements,
             vector: vec![0; elements * u64s_per_elem],
         }
     }

     /// The range of bits for a given element.
     fn range(&self, element: usize) -> (usize, usize) {
         let u64s_per_elem = u64s(self.elements);
         let start = element * u64s_per_elem;
         (start, start + u64s_per_elem)
     }

     pub fn add(&mut self, source: usize, target: usize) -> bool {
         let (start, _) = self.range(source);
         let (word, mask) = word_mask(target);
         let mut vector = &mut self.vector[..];
         let v1 = vector[start + word];
         let v2 = v1 | mask;
         vector[start + word] = v2;
         v1 != v2
     }

     /// Do the bits from `source` contain `target`?
     ///
     /// Put another way, if the matrix represents (transitive)
     /// reachability, can `source` reach `target`?
     pub fn contains(&self, source: usize, target: usize) -> bool {
         let (start, _) = self.range(source);
         let (word, mask) = word_mask(target);
         (self.vector[start + word] & mask) != 0
     }

     /// Returns those indices that are reachable from both `a` and
     /// `b`. This is an O(n) operation where `n` is the number of
     /// elements (somewhat independent from the actual size of the
     /// intersection, in particular).
     pub fn intersection(&self, a: usize, b: usize) -> Vec<usize> {
         let (a_start, a_end) = self.range(a);
         let (b_start, b_end) = self.range(b);
         let mut result = Vec::with_capacity(self.elements);
         for (base, (i, j)) in (a_start..a_end).zip(b_start..b_end).enumerate() {
             let mut v = self.vector[i] & self.vector[j];
             for bit in 0..64 {
                 if v == 0 {
                     break;
                 }
                 if v & 0x1 != 0 {
                     result.push(base * 64 + bit);
                 }
                 v >>= 1;
             }
         }
         result
     }

     /// Add the bits from `read` to the bits from `write`,
     /// return true if anything changed.
     ///
     /// This is used when computing transitive reachability because if
     /// you have an edge `write -> read`, because in that case
     /// `write` can reach everything that `read` can (and
     /// potentially more).
     pub fn merge(&mut self, read: usize, write: usize) -> bool {
         let (read_start, read_end) = self.range(read);
         let (write_start, write_end) = self.range(write);
         let vector = &mut self.vector[..];
         let mut changed = false;
         for (read_index, write_index) in (read_start..read_end).zip(write_start..write_end) {
             let v1 = vector[write_index];
             let v2 = v1 | vector[read_index];
             vector[write_index] = v2;
             changed = changed | (v1 != v2);
         }
         changed
     }
 }

 fn u64s(elements: usize) -> usize {
     (elements + 63) / 64
 }

 fn word_mask(index: usize) -> (usize, u64) {
     let word = index / 64;
     let mask = 1 << (index % 64);
     (word, mask)
 }

 #[test]
 fn bitvec_iter_works() {
     let mut bitvec = BitVector::new(100);
     bitvec.insert(1);
     bitvec.insert(10);
     bitvec.insert(19);
     bitvec.insert(62);
     bitvec.insert(63);
     bitvec.insert(64);
     bitvec.insert(65);
     bitvec.insert(66);
     bitvec.insert(99);
     assert_eq!(bitvec.iter().collect::<Vec<_>>(),
                [1, 10, 19, 62, 63, 64, 65, 66, 99]);
 }

 #[test]
 fn bitvec_iter_works_2() {
     let mut bitvec = BitVector::new(300);
     bitvec.insert(1);
     bitvec.insert(10);
     bitvec.insert(19);
     bitvec.insert(62);
     bitvec.insert(66);
     bitvec.insert(99);
     bitvec.insert(299);
     assert_eq!(bitvec.iter().collect::<Vec<_>>(),
                [1, 10, 19, 62, 66, 99, 299]);

 }

 #[test]
 fn bitvec_iter_works_3() {
     let mut bitvec = BitVector::new(319);
     bitvec.insert(0);
     bitvec.insert(127);
     bitvec.insert(191);
     bitvec.insert(255);
     bitvec.insert(319);
     assert_eq!(bitvec.iter().collect::<Vec<_>>(), [0, 127, 191, 255, 319]);
 }

 #[test]
 fn union_two_vecs() {
     let mut vec1 = BitVector::new(65);
     let mut vec2 = BitVector::new(65);
     assert!(vec1.insert(3));
     assert!(!vec1.insert(3));
     assert!(vec2.insert(5));
     assert!(vec2.insert(64));
     assert!(vec1.insert_all(&vec2));
     assert!(!vec1.insert_all(&vec2));
     assert!(vec1.contains(3));
     assert!(!vec1.contains(4));
     assert!(vec1.contains(5));
     assert!(!vec1.contains(63));
     assert!(vec1.contains(64));
 }

 #[test]
 fn grow() {
     let mut vec1 = BitVector::new(65);
     assert!(vec1.insert(3));
     assert!(!vec1.insert(3));
     assert!(vec1.insert(5));
     assert!(vec1.insert(64));
     vec1.grow(128);
     assert!(vec1.contains(3));
     assert!(vec1.contains(5));
     assert!(vec1.contains(64));
     assert!(!vec1.contains(126));
 }

 #[test]
 fn matrix_intersection() {
     let mut vec1 = BitMatrix::new(200);

     // (*) Elements reachable from both 2 and 65.

     vec1.add(2, 3);
     vec1.add(2, 6);
     vec1.add(2, 10); // (*)
     vec1.add(2, 64); // (*)
     vec1.add(2, 65);
     vec1.add(2, 130);
     vec1.add(2, 160); // (*)

     vec1.add(64, 133);

     vec1.add(65, 2);
     vec1.add(65, 8);
     vec1.add(65, 10); // (*)
     vec1.add(65, 64); // (*)
     vec1.add(65, 68);
     vec1.add(65, 133);
     vec1.add(65, 160); // (*)

     let intersection = vec1.intersection(2, 64);
     assert!(intersection.is_empty());

     let intersection = vec1.intersection(2, 65);
     assert_eq!(intersection, &[10, 64, 160]);
 }
	// Copyright 2015 The Rust Project Developers. See the COPYRIGHT
	// file at the top-level directory of this distribution and at
	// http://rust-lang.org/COPYRIGHT.
	//
	// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
	// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
	// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
	// option. This file may not be copied, modified, or distributed
	// except according to those terms.

	/// A very simple BitVector type.
	pub struct BitVector {
	data: Vec<u64>,
	}

	impl BitVector {
	pub fn new(num_bits: usize) -> BitVector {
	let num_words = u64s(num_bits);
	BitVector { data: vec![0; num_words] }
	}

	pub fn contains(&self, bit: usize) -> bool {
	let (word, mask) = word_mask(bit);
	(self.data[word] & mask) != 0
	}

	/// Returns true if the bit has changed.
	pub fn insert(&mut self, bit: usize) -> bool {
	let (word, mask) = word_mask(bit);
	let data = &mut self.data[word];
	let value = *data;
	let new_value = value \| mask;
	*data = new_value;
	new_value != value
	}

	pub fn insert_all(&mut self, all: &BitVector) -> bool {
	assert!(self.data.len() == all.data.len());
	let mut changed = false;
	for (i, j) in self.data.iter_mut().zip(&all.data) {
	let value = *i;
	i = value \| j;
	if value != *i {
	changed = true;
	}
	}
	changed
	}

	pub fn grow(&mut self, num_bits: usize) {
	let num_words = u64s(num_bits);
	let extra_words = self.data.len() - num_words;
	self.data.extend((0..extra_words).map(\|_\| 0));
	}

	/// Iterates over indexes of set bits in a sorted order
	pub fn iter<'a>(&'a self) -> BitVectorIter<'a> {
	BitVectorIter {
	iter: self.data.iter(),
	current: 0,
	idx: 0,
	}
	}
	}

	pub struct BitVectorIter<'a> {
	iter: ::std::slice::Iter<'a, u64>,
	current: u64,
	idx: usize,
	}

	impl<'a> Iterator for BitVectorIter<'a> {
	type Item = usize;
	fn next(&mut self) -> Option<usize> {
	while self.current == 0 {
	self.current = if let Some(&i) = self.iter.next() {
	if i == 0 {
	self.idx += 64;
	continue;
	} else {
	self.idx = u64s(self.idx) * 64;
	i
	}
	} else {
	return None;
	}
	}
	let offset = self.current.trailing_zeros() as usize;
	self.current >>= offset;
	self.current >>= 1; // shift otherwise overflows for 0b1000_0000_…_0000
	self.idx += offset + 1;
	return Some(self.idx - 1);
	}
	}

	/// A "bit matrix" is basically a square matrix of booleans
	/// represented as one gigantic bitvector. In other words, it is as if
	/// you have N bitvectors, each of length N. Note that `elements` here is `N`/
	#[derive(Clone)]
	pub struct BitMatrix {
	elements: usize,
	vector: Vec<u64>,
	}

	impl BitMatrix {
	// Create a new `elements x elements` matrix, initially empty.
	pub fn new(elements: usize) -> BitMatrix {
	// For every element, we need one bit for every other
	// element. Round up to an even number of u64s.
	let u64s_per_elem = u64s(elements);
	BitMatrix {
	elements: elements,
	vector: vec![0; elements * u64s_per_elem],
	}
	}

	/// The range of bits for a given element.
	fn range(&self, element: usize) -> (usize, usize) {
	let u64s_per_elem = u64s(self.elements);
	let start = element * u64s_per_elem;
	(start, start + u64s_per_elem)
	}

	pub fn add(&mut self, source: usize, target: usize) -> bool {
	let (start, _) = self.range(source);
	let (word, mask) = word_mask(target);
	let mut vector = &mut self.vector[..];
	let v1 = vector[start + word];
	let v2 = v1 \| mask;
	vector[start + word] = v2;
	v1 != v2
	}

	/// Do the bits from `source` contain `target`?
	///
	/// Put another way, if the matrix represents (transitive)
	/// reachability, can `source` reach `target`?
	pub fn contains(&self, source: usize, target: usize) -> bool {
	let (start, _) = self.range(source);
	let (word, mask) = word_mask(target);
	(self.vector[start + word] & mask) != 0
	}

	/// Returns those indices that are reachable from both `a` and
	/// `b`. This is an O(n) operation where `n` is the number of
	/// elements (somewhat independent from the actual size of the
	/// intersection, in particular).
	pub fn intersection(&self, a: usize, b: usize) -> Vec<usize> {
	let (a_start, a_end) = self.range(a);
	let (b_start, b_end) = self.range(b);
	let mut result = Vec::with_capacity(self.elements);
	for (base, (i, j)) in (a_start..a_end).zip(b_start..b_end).enumerate() {
	let mut v = self.vector[i] & self.vector[j];
	for bit in 0..64 {
	if v == 0 {
	break;
	}
	if v & 0x1 != 0 {
	result.push(base * 64 + bit);
	}
	v >>= 1;
	}
	}
	result
	}

	/// Add the bits from `read` to the bits from `write`,
	/// return true if anything changed.
	///
	/// This is used when computing transitive reachability because if
	/// you have an edge `write -> read`, because in that case
	/// `write` can reach everything that `read` can (and
	/// potentially more).
	pub fn merge(&mut self, read: usize, write: usize) -> bool {
	let (read_start, read_end) = self.range(read);
	let (write_start, write_end) = self.range(write);
	let vector = &mut self.vector[..];
	let mut changed = false;
	for (read_index, write_index) in (read_start..read_end).zip(write_start..write_end) {
	let v1 = vector[write_index];
	let v2 = v1 \| vector[read_index];
	vector[write_index] = v2;
	changed = changed \| (v1 != v2);
	}
	changed
	}
	}

	fn u64s(elements: usize) -> usize {
	(elements + 63) / 64
	}

	fn word_mask(index: usize) -> (usize, u64) {
	let word = index / 64;
	let mask = 1 << (index % 64);
	(word, mask)
	}

	#[test]
	fn bitvec_iter_works() {
	let mut bitvec = BitVector::new(100);
	bitvec.insert(1);
	bitvec.insert(10);
	bitvec.insert(19);
	bitvec.insert(62);
	bitvec.insert(63);
	bitvec.insert(64);
	bitvec.insert(65);
	bitvec.insert(66);
	bitvec.insert(99);
	assert_eq!(bitvec.iter().collect::<Vec<_>>(),
	[1, 10, 19, 62, 63, 64, 65, 66, 99]);
	}

	#[test]
	fn bitvec_iter_works_2() {
	let mut bitvec = BitVector::new(300);
	bitvec.insert(1);
	bitvec.insert(10);
	bitvec.insert(19);
	bitvec.insert(62);
	bitvec.insert(66);
	bitvec.insert(99);
	bitvec.insert(299);
	assert_eq!(bitvec.iter().collect::<Vec<_>>(),
	[1, 10, 19, 62, 66, 99, 299]);

	}

	#[test]
	fn bitvec_iter_works_3() {
	let mut bitvec = BitVector::new(319);
	bitvec.insert(0);
	bitvec.insert(127);
	bitvec.insert(191);
	bitvec.insert(255);
	bitvec.insert(319);
	assert_eq!(bitvec.iter().collect::<Vec<_>>(), [0, 127, 191, 255, 319]);
	}

	#[test]
	fn union_two_vecs() {
	let mut vec1 = BitVector::new(65);
	let mut vec2 = BitVector::new(65);
	assert!(vec1.insert(3));
	assert!(!vec1.insert(3));
	assert!(vec2.insert(5));
	assert!(vec2.insert(64));
	assert!(vec1.insert_all(&vec2));
	assert!(!vec1.insert_all(&vec2));
	assert!(vec1.contains(3));
	assert!(!vec1.contains(4));
	assert!(vec1.contains(5));
	assert!(!vec1.contains(63));
	assert!(vec1.contains(64));
	}

	#[test]
	fn grow() {
	let mut vec1 = BitVector::new(65);
	assert!(vec1.insert(3));
	assert!(!vec1.insert(3));
	assert!(vec1.insert(5));
	assert!(vec1.insert(64));
	vec1.grow(128);
	assert!(vec1.contains(3));
	assert!(vec1.contains(5));
	assert!(vec1.contains(64));
	assert!(!vec1.contains(126));
	}

	#[test]
	fn matrix_intersection() {
	let mut vec1 = BitMatrix::new(200);

	// (*) Elements reachable from both 2 and 65.

	vec1.add(2, 3);
	vec1.add(2, 6);
	vec1.add(2, 10); // (*)
	vec1.add(2, 64); // (*)
	vec1.add(2, 65);
	vec1.add(2, 130);
	vec1.add(2, 160); // (*)

	vec1.add(64, 133);

	vec1.add(65, 2);
	vec1.add(65, 8);
	vec1.add(65, 10); // (*)
	vec1.add(65, 64); // (*)
	vec1.add(65, 68);
	vec1.add(65, 133);
	vec1.add(65, 160); // (*)

	let intersection = vec1.intersection(2, 64);
	assert!(intersection.is_empty());

	let intersection = vec1.intersection(2, 65);
	assert_eq!(intersection, &[10, 64, 160]);
	}