2015-09-18 01:44:31 +02:00
|
|
|
/*
|
2019-04-09 20:39:42 +02:00
|
|
|
* MinIO Cloud Storage, (C) 2014, 2015, 2016, 2017 MinIO, Inc.
|
2015-09-18 01:44:31 +02:00
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*/
|
|
|
|
|
2017-02-10 20:51:41 +01:00
|
|
|
// Package trie implements a simple trie tree for minio server/tools borrows
|
|
|
|
// idea from - https://godoc.org/golang.org/x/text/internal/triegen.
|
|
|
|
package trie
|
2015-09-18 01:44:31 +02:00
|
|
|
|
2017-02-10 20:51:41 +01:00
|
|
|
// Node trie tree node container carries value and children.
|
|
|
|
type Node struct {
|
2015-09-18 01:44:31 +02:00
|
|
|
exists bool
|
2020-09-21 10:18:13 +02:00
|
|
|
value string
|
2017-02-10 20:51:41 +01:00
|
|
|
child map[rune]*Node // runes as child.
|
2015-09-18 01:44:31 +02:00
|
|
|
}
|
|
|
|
|
2017-02-10 20:51:41 +01:00
|
|
|
// newNode create a new trie node.
|
|
|
|
func newNode() *Node {
|
|
|
|
return &Node{
|
2015-09-18 01:44:31 +02:00
|
|
|
exists: false,
|
2020-09-21 10:18:13 +02:00
|
|
|
value: "",
|
2017-02-10 20:51:41 +01:00
|
|
|
child: make(map[rune]*Node),
|
2015-09-18 01:44:31 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-02-10 20:51:41 +01:00
|
|
|
// Trie is a trie container.
|
|
|
|
type Trie struct {
|
|
|
|
root *Node
|
|
|
|
size int
|
|
|
|
}
|
|
|
|
|
|
|
|
// Root returns root node.
|
|
|
|
func (t *Trie) Root() *Node {
|
|
|
|
return t.root
|
|
|
|
}
|
|
|
|
|
|
|
|
// Insert insert a key.
|
2015-09-18 01:44:31 +02:00
|
|
|
func (t *Trie) Insert(key string) {
|
|
|
|
curNode := t.root
|
|
|
|
for _, v := range key {
|
|
|
|
if curNode.child[v] == nil {
|
2017-02-10 20:51:41 +01:00
|
|
|
curNode.child[v] = newNode()
|
2015-09-18 01:44:31 +02:00
|
|
|
}
|
|
|
|
curNode = curNode.child[v]
|
|
|
|
}
|
|
|
|
|
|
|
|
if !curNode.exists {
|
2017-02-10 20:51:41 +01:00
|
|
|
// increment when new rune child is added.
|
2015-09-18 01:44:31 +02:00
|
|
|
t.size++
|
|
|
|
curNode.exists = true
|
|
|
|
}
|
2017-02-10 20:51:41 +01:00
|
|
|
// value is stored for retrieval in future.
|
2015-09-18 01:44:31 +02:00
|
|
|
curNode.value = key
|
|
|
|
}
|
|
|
|
|
2017-02-10 20:51:41 +01:00
|
|
|
// PrefixMatch - prefix match.
|
2020-09-21 10:18:13 +02:00
|
|
|
func (t *Trie) PrefixMatch(key string) []string {
|
2015-09-18 01:44:31 +02:00
|
|
|
node, _ := t.findNode(key)
|
2020-09-21 10:18:13 +02:00
|
|
|
if node == nil {
|
|
|
|
return nil
|
2015-09-18 01:44:31 +02:00
|
|
|
}
|
2020-09-21 10:18:13 +02:00
|
|
|
return t.Walk(node)
|
2015-09-18 01:44:31 +02:00
|
|
|
}
|
|
|
|
|
2017-02-10 20:51:41 +01:00
|
|
|
// Walk the tree.
|
2020-09-21 10:18:13 +02:00
|
|
|
func (t *Trie) Walk(node *Node) (ret []string) {
|
2015-09-18 01:44:31 +02:00
|
|
|
if node.exists {
|
|
|
|
ret = append(ret, node.value)
|
|
|
|
}
|
|
|
|
for _, v := range node.child {
|
2017-02-10 20:51:41 +01:00
|
|
|
ret = append(ret, t.Walk(v)...)
|
2015-09-18 01:44:31 +02:00
|
|
|
}
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2017-02-10 20:51:41 +01:00
|
|
|
// find nodes corresponding to key.
|
|
|
|
func (t *Trie) findNode(key string) (node *Node, index int) {
|
2015-09-18 01:44:31 +02:00
|
|
|
curNode := t.root
|
|
|
|
f := false
|
|
|
|
for k, v := range key {
|
|
|
|
if f {
|
|
|
|
index = k
|
|
|
|
f = false
|
|
|
|
}
|
|
|
|
if curNode.child[v] == nil {
|
|
|
|
return nil, index
|
|
|
|
}
|
|
|
|
curNode = curNode.child[v]
|
|
|
|
if curNode.exists {
|
|
|
|
f = true
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if curNode.exists {
|
|
|
|
index = len(key)
|
|
|
|
}
|
|
|
|
|
|
|
|
return curNode, index
|
|
|
|
}
|
2017-02-10 20:51:41 +01:00
|
|
|
|
|
|
|
// NewTrie create a new trie.
|
|
|
|
func NewTrie() *Trie {
|
|
|
|
return &Trie{
|
|
|
|
root: newNode(),
|
|
|
|
size: 0,
|
|
|
|
}
|
|
|
|
}
|