bytestring-trie: An efficient finite map from bytestrings to values.
An efficient finite map from bytestrings to values.
The implementation is based on big-endian patricia trees, like Data.IntMap. We first trie on the elements of Data.ByteString and then trie on the big-endian bit representation of those elements. Patricia trees have efficient algorithms for union and other merging operations, but they're also quick for lookups and insertions.
If you are only interested in being able to associate strings
to values, then you may prefer the hashmap package which is
faster for those only needing a map-like structure. This package
is intended for those who need the extra capabilities that a
trie-like structure can offer (e.g., structure sharing to reduce
memory costs for highly redundant keys, taking the submap of
all keys with a given prefix, contextual mapping, extracting
the minimum and maximum keys, etc.)
[Skip to Readme]
Downloads
- bytestring-trie-0.2.7.5.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
- No Candidates
| Versions [RSS] | 0.1, 0.1.1, 0.1.2, 0.1.3, 0.1.4, 0.2.2, 0.2.3, 0.2.4, 0.2.4.1, 0.2.4.3, 0.2.5.0, 0.2.5.1, 0.2.5.2, 0.2.5.3, 0.2.6, 0.2.7, 0.2.7.1, 0.2.7.2, 0.2.7.3, 0.2.7.4, 0.2.7.5 |
|---|---|
| Change log | CHANGELOG |
| Dependencies | base (>=4.9 && <4.21), binary (>=0.8.3 && <0.9), bytestring (>=0.10.8 && <0.13), deepseq (>=1.4.2 && <1.6) [details] |
| License | BSD-3-Clause |
| Copyright | 2008–2024 wren gayle romano |
| Author | wren gayle romano |
| Maintainer | wren@cpan.org |
| Category | Data, Data Structures |
| Home page | https://wrengr.org/software/hackage.html |
| Bug tracker | https://github.com/wrengr/bytestring-trie/issues |
| Source repo | head: git clone https://github.com/wrengr/bytestring-trie.git |
| Uploaded | by WrenRomano at 2024-08-29T22:24:56Z |
| Distributions | Fedora:0.2.7.2, LTSHaskell:0.2.7.5, NixOS:0.2.7.3, Stackage:0.2.7.5 |
| Reverse Dependencies | 24 direct, 360 indirect [details] |
| Downloads | 24905 total (126 in the last 30 days) |
| Rating | 2.5 (votes: 4) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs available [build log] Last success reported on 2024-08-29 [all 1 reports] |
Readme for bytestring-trie-0.2.7.5
[back to package description]bytestring-trie
The bytestring-trie package provides an efficient implementation
of tries mapping ByteString to values. The implementation is
based on Okasaki's big-endian patricia trees, à la IntMap. We
first trie on the elements of ByteString and then trie on the
big-endian bit representation of those elements. Patricia trees
have efficient algorithms for union and other merging operations,
but they're also quick for lookups and insertions.
If you are only interested in being able to associate individual
ByteStrings to values, then you may prefer the hashmap package
which is faster for those only needing a map-like structure. This
package is intended for those who need the extra capabilities that
a trie-like structure can offer (e.g., structure sharing to reduce
memory costs for highly redundant keys, taking the submap of all
keys with a given prefix, contextual mapping, extracting the minimum
and maximum keys, etc.)
Install
This is a simple package and should be easy to install. You should be able to use the standard:
$> cabal install bytestring-trie
Portability
The implementation is quite portable, relying only on a few basic language extensions. The complete list of extensions used by the library is:
- CPP
- MagicHash -- Only if using GHC
- NoImplicitPrelude
The test suite uses a few additional extensions:
- MultiParamTypeClasses
- FlexibleInstances
- FlexibleContexts