|
| htrie_set (const Hash &hash=Hash()) |
|
| htrie_set (size_type burst_threshold, const Hash &hash=Hash()) |
|
template<class InputIt , typename std::enable_if< is_iterator< InputIt >::value >::type * = nullptr> |
| htrie_set (InputIt first, InputIt last, const Hash &hash=Hash()) |
|
| htrie_set (std::initializer_list< std::basic_string_view< CharT >> init, const Hash &hash=Hash()) |
|
htrie_set & | operator= (std::initializer_list< std::basic_string_view< CharT >> ilist) |
|
iterator | begin () noexcept |
|
const_iterator | begin () const noexcept |
|
const_iterator | cbegin () const noexcept |
|
iterator | end () noexcept |
|
const_iterator | end () const noexcept |
|
const_iterator | cend () const noexcept |
|
bool | empty () const noexcept |
|
size_type | size () const noexcept |
|
size_type | max_size () const noexcept |
|
size_type | max_key_size () const noexcept |
|
void | shrink_to_fit () |
|
void | clear () noexcept |
|
std::pair< iterator, bool > | insert_ks (const CharT *key, size_type key_size) |
|
std::pair< iterator, bool > | insert (const std::basic_string_view< CharT > &key) |
|
template<class InputIt , typename std::enable_if< is_iterator< InputIt >::value >::type * = nullptr> |
void | insert (InputIt first, InputIt last) |
|
void | insert (std::initializer_list< std::basic_string_view< CharT >> ilist) |
|
std::pair< iterator, bool > | emplace_ks (const CharT *key, size_type key_size) |
|
std::pair< iterator, bool > | emplace (const std::basic_string_view< CharT > &key) |
|
iterator | erase (const_iterator pos) |
|
iterator | erase (const_iterator first, const_iterator last) |
|
size_type | erase_ks (const CharT *key, size_type key_size) |
|
size_type | erase (const std::basic_string_view< CharT > &key) |
|
size_type | erase_prefix_ks (const CharT *prefix, size_type prefix_size) |
|
size_type | erase_prefix (const std::basic_string_view< CharT > &prefix) |
|
void | swap (htrie_set &other) |
|
size_type | count_ks (const CharT *key, size_type key_size) const |
|
size_type | count (const std::basic_string_view< CharT > &key) const |
|
iterator | find_ks (const CharT *key, size_type key_size) |
|
const_iterator | find_ks (const CharT *key, size_type key_size) const |
|
iterator | find (const std::basic_string_view< CharT > &key) |
|
const_iterator | find (const std::basic_string_view< CharT > &key) const |
|
std::pair< iterator, iterator > | equal_range_ks (const CharT *key, size_type key_size) |
|
std::pair< const_iterator, const_iterator > | equal_range_ks (const CharT *key, size_type key_size) const |
|
std::pair< iterator, iterator > | equal_range (const std::basic_string_view< CharT > &key) |
|
std::pair< const_iterator, const_iterator > | equal_range (const std::basic_string_view< CharT > &key) const |
|
std::pair< prefix_iterator, prefix_iterator > | equal_prefix_range_ks (const CharT *prefix, size_type prefix_size) |
|
std::pair< const_prefix_iterator, const_prefix_iterator > | equal_prefix_range_ks (const CharT *prefix, size_type prefix_size) const |
|
std::pair< prefix_iterator, prefix_iterator > | equal_prefix_range (const std::basic_string_view< CharT > &prefix) |
|
std::pair< const_prefix_iterator, const_prefix_iterator > | equal_prefix_range (const std::basic_string_view< CharT > &prefix) const |
|
iterator | longest_prefix_ks (const CharT *key, size_type key_size) |
|
const_iterator | longest_prefix_ks (const CharT *key, size_type key_size) const |
|
iterator | longest_prefix (const std::basic_string_view< CharT > &key) |
|
const_iterator | longest_prefix (const std::basic_string_view< CharT > &key) const |
|
float | max_load_factor () const |
|
void | max_load_factor (float ml) |
|
size_type | burst_threshold () const |
|
void | burst_threshold (size_type threshold) |
|
hasher | hash_function () const |
|
template<class Serializer > |
void | serialize (Serializer &serializer) const |
|
template<class CharT, class Hash = tsl::ah::str_hash<CharT>, class KeySizeT = std::uint16_t>
class tsl::htrie_set< CharT, Hash, KeySizeT >
Implementation of a hat-trie set.
The size of a key string is limited to std::numeric_limits<KeySizeT>::max() - 1. That is 65 535 characters by default, but can be raised with the KeySizeT template parameter. See max_key_size() for an easy access to this limit.
Iterators invalidation:
- clear, operator=: always invalidate the iterators.
- insert: always invalidate the iterators.
- erase: always invalidate the iterators.
template<class CharT , class Hash = tsl::ah::str_hash<CharT>, class KeySizeT = std::uint16_t>
template<class Deserializer >
static htrie_set tsl::htrie_set< CharT, Hash, KeySizeT >::deserialize |
( |
Deserializer & |
deserializer, |
|
|
bool |
hash_compatible = false |
|
) |
| |
|
inlinestatic |
Deserialize a previouly serialized set through the deserializer
parameter.
The deserializer
parameter must be a function object that supports the following calls:
template<typename U> U operator()();
where the types std::uint64_t
and float
must be supported for U.
void operator()(CharT* value_out, std::size_t value_size);
If the deserialized hash set part of the hat-trie is hash compatible with the serialized set, the deserialization process can be sped up by setting hash_compatible
to true. To be hash compatible, the Hash (take care of the 32-bits vs 64 bits), and KeySizeT must behave the same than the ones used in the serialized set. Otherwise the behaviour is undefined with hash_compatible
sets to true.
The behaviour is undefined if the type CharT
of the htrie_set
is not the same as the type used during serialization.
The implementation leaves binary compatibilty (endianness, IEEE 754 for floats, size of int, ...) of the types it deserializes in the hands of the Deserializer
function object if compatibilty is required.
template<class CharT , class Hash = tsl::ah::str_hash<CharT>, class KeySizeT = std::uint16_t>
iterator tsl::htrie_set< CharT, Hash, KeySizeT >::longest_prefix |
( |
const std::basic_string_view< CharT > & |
key | ) |
|
|
inline |
Return the element in the trie which is the longest prefix of key
. If no element in the trie is a prefix of key
, the end iterator is returned.
Example:
tsl::htrie_set<char> set = {"/foo", "/foo/bar"};
set.longest_prefix("/foo"); // returns "/foo"
set.longest_prefix("/foo/baz"); // returns "/foo"
set.longest_prefix("/foo/bar/baz"); // returns "/foo/bar"
set.longest_prefix("/foo/bar/"); // returns "/foo/bar"
set.longest_prefix("/bar"); // returns end()
set.longest_prefix(""); // returns end()
template<class CharT , class Hash = tsl::ah::str_hash<CharT>, class KeySizeT = std::uint16_t>
Return the element in the trie which is the longest prefix of key
. If no element in the trie is a prefix of key
, the end iterator is returned.
Example:
tsl::htrie_set<char> set = {"/foo", "/foo/bar"};
set.longest_prefix("/foo"); // returns "/foo"
set.longest_prefix("/foo/baz"); // returns "/foo"
set.longest_prefix("/foo/bar/baz"); // returns "/foo/bar"
set.longest_prefix("/foo/bar/"); // returns "/foo/bar"
set.longest_prefix("/bar"); // returns end()
set.longest_prefix(""); // returns end()
template<class CharT , class Hash = tsl::ah::str_hash<CharT>, class KeySizeT = std::uint16_t>
Return the element in the trie which is the longest prefix of key
. If no element in the trie is a prefix of key
, the end iterator is returned.
Example:
tsl::htrie_set<char> set = {"/foo", "/foo/bar"};
set.longest_prefix("/foo"); // returns "/foo"
set.longest_prefix("/foo/baz"); // returns "/foo"
set.longest_prefix("/foo/bar/baz"); // returns "/foo/bar"
set.longest_prefix("/foo/bar/"); // returns "/foo/bar"
set.longest_prefix("/bar"); // returns end()
set.longest_prefix(""); // returns end()
template<class CharT , class Hash = tsl::ah::str_hash<CharT>, class KeySizeT = std::uint16_t>
Return the element in the trie which is the longest prefix of key
. If no element in the trie is a prefix of key
, the end iterator is returned.
Example:
tsl::htrie_set<char> set = {"/foo", "/foo/bar"};
set.longest_prefix("/foo"); // returns "/foo"
set.longest_prefix("/foo/baz"); // returns "/foo"
set.longest_prefix("/foo/bar/baz"); // returns "/foo/bar"
set.longest_prefix("/foo/bar/"); // returns "/foo/bar"
set.longest_prefix("/bar"); // returns end()
set.longest_prefix(""); // returns end()
template<class CharT , class Hash = tsl::ah::str_hash<CharT>, class KeySizeT = std::uint16_t>
template<class Serializer >
void tsl::htrie_set< CharT, Hash, KeySizeT >::serialize |
( |
Serializer & |
serializer | ) |
const |
|
inline |
Serialize the set through the serializer
parameter.
The serializer
parameter must be a function object that supports the following calls:
void operator()(const U& value);
where the types std::uint64_t
and float
must be supported for U.
void operator()(const CharT* value, std::size_t value_size);
The implementation leaves binary compatibilty (endianness, IEEE 754 for floats, ...) of the types it serializes in the hands of the Serializer
function object if compatibilty is required.