Expose internal bytes of Symbol (#131)

Author: a1412744807

src/builder.rs

@@ -632,7 +632,7 @@ impl CompressorBuilder {
         let ignored_bits = entry.ignored_bits;
 
         // If the entry is valid, return the code
-        if !entry.is_unused() && compare_masked(word, entry.symbol.as_u64(), ignored_bits) {
+        if !entry.is_unused() && compare_masked(word, entry.symbol.to_u64(), ignored_bits) {
             return entry.code;
         }
 

src/lib.rs

@@ -65,8 +65,9 @@ impl Symbol {
         if len == 0 { 1 } else { len }
     }
 
+    /// Returns the Symbol's inner representation.
     #[inline]
-    fn as_u64(self) -> u64 {
+    pub fn to_u64(self) -> u64 {
         self.0
     }
 
@@ -303,7 +304,7 @@ impl<'a> Decompressor<'a> {
                 ($code:expr) => {{
                     out_ptr
                         .cast::<u64>()
-                        .write_unaligned(self.symbols.get_unchecked($code as usize).as_u64());
+                        .write_unaligned(self.symbols.get_unchecked($code as usize).to_u64());
                     out_ptr = out_ptr.add(*self.lengths.get_unchecked($code as usize) as usize);
                 }};
             }
@@ -588,7 +589,7 @@ impl Compressor {
             // Now, downshift the `word` and the `entry` to see if they align.
             let ignored_bits = entry.ignored_bits;
             if entry.code != Code::UNUSED
-                && compare_masked(word, entry.symbol.as_u64(), ignored_bits)
+                && compare_masked(word, entry.symbol.to_u64(), ignored_bits)
             {
                 // Advance the input by the symbol length (variable) and the output by one code byte
                 // SAFETY: out_ptr is not null.

src/lossy_pht.rs

@@ -79,7 +79,7 @@ impl LossyPHT {
     ///
     /// True if the symbol was inserted into the table, false if it was rejected due to collision.
     pub(crate) fn insert(&mut self, symbol: Symbol, len: usize, code: u8) -> bool {
-        let prefix_3bytes = symbol.as_u64() & 0xFF_FF_FF;
+        let prefix_3bytes = symbol.to_u64() & 0xFF_FF_FF;
         let slot = fsst_hash(prefix_3bytes) as usize & (HASH_TABLE_SIZE - 1);
         let entry = &mut self.slots[slot];
         if !entry.is_unused() {
@@ -106,7 +106,7 @@ impl LossyPHT {
 
     /// Remove the symbol from the hashtable, if it exists.
     pub(crate) fn remove(&mut self, symbol: Symbol) {
-        let prefix_3bytes = symbol.as_u64() & 0xFF_FF_FF;
+        let prefix_3bytes = symbol.to_u64() & 0xFF_FF_FF;
         let slot = fsst_hash(prefix_3bytes) as usize & (HASH_TABLE_SIZE - 1);
         self.slots[slot].code = Code::UNUSED;
     }