dnscrypt-proxy/vendor/github.com/hashicorp/go-immutable-radix
Frank Denis e54056bc38 Update deps 2020-09-18 18:19:55 +02:00
..
.gitignore Implement blocking, fully compatible with rules from version 1 2018-01-17 02:40:47 +01:00
CHANGELOG.md Update deps 2020-09-18 18:19:55 +02:00
LICENSE Implement blocking, fully compatible with rules from version 1 2018-01-17 02:40:47 +01:00
README.md Update deps 2020-03-19 10:18:43 +01:00
edges.go Implement blocking, fully compatible with rules from version 1 2018-01-17 02:40:47 +01:00
go.mod Update deps for Go 1.11 2018-10-02 18:06:43 +02:00
go.sum Update deps for Go 1.11 2018-10-02 18:06:43 +02:00
iradix.go Update deps 2020-03-19 10:18:43 +01:00
iter.go Update deps 2020-09-18 18:19:55 +02:00
node.go Update deps 2020-09-18 18:19:55 +02:00
raw_iter.go Update deps 2020-09-18 18:19:55 +02:00
reverse_iter.go Update deps 2020-09-18 18:19:55 +02:00

README.md

go-immutable-radix CircleCI

Provides the iradix package that implements an immutable radix tree. The package only provides a single Tree implementation, optimized for sparse nodes.

As a radix tree, it provides the following:

  • O(k) operations. In many cases, this can be faster than a hash table since the hash function is an O(k) operation, and hash tables have very poor cache locality.
  • Minimum / Maximum value lookups
  • Ordered iteration

A tree supports using a transaction to batch multiple updates (insert, delete) in a more efficient manner than performing each operation one at a time.

For a mutable variant, see go-radix.

Documentation

The full documentation is available on Godoc.

Example

Below is a simple example of usage

// Create a tree
r := iradix.New()
r, _, _ = r.Insert([]byte("foo"), 1)
r, _, _ = r.Insert([]byte("bar"), 2)
r, _, _ = r.Insert([]byte("foobar"), 2)

// Find the longest prefix match
m, _, _ := r.Root().LongestPrefix([]byte("foozip"))
if string(m) != "foo" {
    panic("should be foo")
}

Here is an example of performing a range scan of the keys.

// Create a tree
r := iradix.New()
r, _, _ = r.Insert([]byte("001"), 1)
r, _, _ = r.Insert([]byte("002"), 2)
r, _, _ = r.Insert([]byte("005"), 5)
r, _, _ = r.Insert([]byte("010"), 10)
r, _, _ = r.Insert([]byte("100"), 10)

// Range scan over the keys that sort lexicographically between [003, 050)
it := r.Root().Iterator()
it.SeekLowerBound([]byte("003"))
for key, _, ok := it.Next(); ok; key, _, ok = it.Next() {
  if key >= "050" {
      break
  }
  fmt.Println(key)
}
// Output:
//  005
//  010