Compile-time Huffman coding compression using C++20
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Clyne 9b019e37aa
Clean up readme, add guide
4 years ago
LICENSE Initial commit 4 years ago
README.md Clean up readme, add guide 4 years ago
consteval_huffman.hpp Rename decoder 4 years ago

README.md

consteval-huffman

A C++20 utility for compressing string literals at compile-time to save program space. The compressed data can be decompressed at run-time through the use of a decoder that follows std::forward_iterator.

Compression is achieved using Huffman coding, which works by creating short codes (measured in bits) for frequently-occuring characters. This works best on larger pieces of data that are limited in their range of values (e.g. written text).

Requirements

A C++20 compliant compiler. consteval-huffman is confirmed to work on gcc 10.1 and later, doesn't work yet on clang.

Use cases

1. Text configurations (e.g. JSON)

A ~3.5kB string of JSON can be compressed down ~2.5kB (see it on Godbolt).

2. Scripts (e.g. Lisp)

A ~40 line comment-including sample of Lisp can be reduced from 1,662 bytes to 1,251 (412 bytes saved) (Godbolt).

3. Numbers?

A string of numbers 1 to 100 separated with spaces can be compressed to 64% of its original size (Godbolt).

How to Use

// 1.
#include "consteval_huffman.hpp"

// 2.
auto data = "This is my string of data"_huffman; // "\0\x1 Non-text data works too!"

// 3.
for (char c : data)
    std::cout << c;

Use data.begin() or data.cbegin() to get an iterator for the data which decompresses the next byte with every increment.
These of course come with end() and cend().

Use data() to get a pointer to the compressed data.

Use size() to get the size of the compressed data.

Should compression not decrease the size of the given data, the data will be stored uncompressed. The above functions will still behave as they should.