Struct q_compress::Flags

pub struct Flags {
    pub use_5_bit_code_len: bool,
    pub delta_encoding_order: usize,
    pub use_min_count_encoding: bool,
}

The configuration stored in a .qco file’s header.

During compression, flags are determined based on your CompressorConfig and the q_compress version. Flags affect the encoding of the rest of the file, so decompressing with the wrong flags will likely cause a corruption error.

Most users will not need to manually instantiate flags; that should be done internally by Compressor::from_config. However, in some circumstances you may want to inspect flags during decompression.

Fields

use_5_bit_code_len: bool

Whether to use 5 bits to encode the length of a prefix Huffman code, as opposed to 4. Earlier versions of q_compress used 4, which was insufficient for Huffman codes that could reach up to 23 in length (23 >= 16 = 2^4) in spiky distributions with high compression level. In later versions, this flag is always true. Introduced in 0.5.0.

delta_encoding_order: usize

How many times delta encoding was applied during compression. This is stored as 3 bits to express 0-7 See CompressorConfig for more details. Introduced in 0.6.0.

use_min_count_encoding: bool

Whether to use the minimum number of bits to encode the count of each prefix, rather than using a constant number of bits. This can reduce file size slightly for small data. In later versions, this flag is always true. Introduced in 0.9.1.

Implementations

impl Flags

pub fn parse_from(reader: &mut BitReader<'_>) -> QCompressResult<Self>

pub fn write(&self, writer: &mut BitWriter) -> QCompressResult<()>

pub fn bits_to_encode_code_len(&self) -> usize

pub fn bits_to_encode_count(&self, n: usize) -> usize

Trait Implementations

impl Clone for Flags

fn clone(&self) -> Flags

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Flags

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&'_ CompressorConfig> for Flags

fn from(config: &CompressorConfig) -> Self

Converts to this type from the input type.

impl PartialEq<Flags> for Flags

fn eq(&self, other: &Flags) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Flags) -> bool

This method tests for !=.

impl TryFrom<Vec<bool, Global>> for Flags

type Error = QCompressError

The type returned in the event of a conversion error.

fn try_from(bools: Vec<bool>) -> QCompressResult<Self>

Performs the conversion.

impl TryInto<Vec<bool, Global>> for &Flags

type Error = QCompressError

The type returned in the event of a conversion error.

fn try_into(self) -> QCompressResult<Vec<bool>>

Performs the conversion.

impl Eq for Flags

impl StructuralEq for Flags

impl StructuralPartialEq for Flags