succinct 0.5.2

Succinct data structures for Rust
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

use super::*;
use internal::errors::*;
use stream::*;

/// Encodes _n_ as _n_ zeroes followed by a one.
pub struct Unary;

impl UniversalCode for Unary {
    fn encode<W: BitWrite>(&self, sink: &mut W, mut value: u64) -> Result<()> {
        while value > 0 {
            try!(sink.write_bit(false));
            value = value - 1;
        }

        try!(sink.write_bit(true));

        Ok(())
    }

    fn decode<R: BitRead>(&self, source: &mut R) -> Result<Option<u64>> {
        let mut result = 0;
        let mut consumed = false;

        while let Some(bit) = try!(source.read_bit()) {
            if bit { return Ok(Some(result)); }
            // This can't overflow because it would require too many
            // unary digits to get there:
            result = result + 1;
            consumed = true;
        }

        if consumed {
            out_of_bits("Unary::decode")
        } else {
            Ok(None)
        }
    }
}

#[cfg(test)]
mod test {
    use std::collections::VecDeque;
    use coding::*;

    #[test]
    fn test234() {
        let mut dv = VecDeque::<bool>::new();

        Unary.encode(&mut dv, 2).unwrap();
        Unary.encode(&mut dv, 3).unwrap();
        Unary.encode(&mut dv, 4).unwrap();

        assert_eq!(Some(2), Unary.decode(&mut dv).unwrap());
        assert_eq!(Some(3), Unary.decode(&mut dv).unwrap());
        assert_eq!(Some(4), Unary.decode(&mut dv).unwrap());
        assert_eq!(None, Unary.decode(&mut dv).unwrap());
    }
}