open-consul/vendor/github.com/hashicorp/go-immutable-radix
Jeff Mitchell b43800125c
Update vendoring from go mod. (#5566)
2019-03-26 17:50:42 -04:00
..
.gitignore Update vendoring from go mod. (#5566) 2019-03-26 17:50:42 -04:00
.travis.yml Update vendoring from go mod. (#5566) 2019-03-26 17:50:42 -04:00
LICENSE Manage dependencies via Godep 2016-02-12 16:50:37 -08:00
README.md Manage dependencies via Godep 2016-02-12 16:50:37 -08:00
edges.go Manage dependencies via Godep 2016-02-12 16:50:37 -08:00
go.mod Update vendoring from go mod. (#5566) 2019-03-26 17:50:42 -04:00
go.sum Update vendoring from go mod. (#5566) 2019-03-26 17:50:42 -04:00
iradix.go Update vendoring from go mod. (#5566) 2019-03-26 17:50:42 -04:00
iter.go Updates go-immutable-radix and go-memdb to get fine-grained watches. 2017-01-25 09:58:22 -08:00
node.go Updates hashicorp/go-immutable-radix to pick up leaf panic fixes. 2017-02-13 16:47:49 -08:00
raw_iter.go Updates go-immutable-radix and go-memdb to get fine-grained watches. 2017-01-25 09:58:22 -08:00

README.md

go-immutable-radix Build Status

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")
}