summaryrefslogtreecommitdiff
path: root/vendor/codeberg.org/gruf/go-structr/key.go
blob: ad591f8ac7d897a5cfcaa7abf3abb97c9c9bfd4e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
package structr

import (
	"sync"

	"codeberg.org/gruf/go-byteutil"
	"codeberg.org/gruf/go-mangler/v2"
)

// Key represents one key to
// lookup (potentially) stored
// entries in an Index.
type Key struct {
	key string
	raw []any
}

// MakeKey generates Key{} from given parts.
func MakeKey(parts ...any) Key {
	buf := new_buffer()
	buf.B = mangler.AppendMulti(buf.B[:0], parts...)
	key := string(buf.B)
	free_buffer(buf)
	return Key{
		raw: parts,
		key: key,
	}
}

// MakeKeys generates []Key{} from given (multiple) parts.
func MakeKeys(parts ...[]any) []Key {
	keys := make([]Key, len(parts))
	if len(keys) != len(parts) {
		panic(assert("BCE"))
	}
	buf := new_buffer()
	for x, parts := range parts {
		buf.B = mangler.AppendMulti(buf.B[:0], parts...)
		key := string(buf.B)
		keys[x] = Key{
			raw: parts,
			key: key,
		}
	}
	free_buffer(buf)
	return keys
}

// Key returns the underlying cache key string.
// NOTE: this will not be log output friendly.
func (k Key) Key() string {
	return k.key
}

// Equal returns whether keys are equal.
func (k Key) Equal(o Key) bool {
	return (k.key == o.key)
}

// Value returns the raw slice of
// values that comprise this Key.
func (k Key) Values() []any {
	return k.raw
}

var buf_pool sync.Pool

// new_buffer returns a new initialized byte buffer.
func new_buffer() *byteutil.Buffer {
	v := buf_pool.Get()
	if v == nil {
		buf := new(byteutil.Buffer)
		buf.B = make([]byte, 0, 512)
		v = buf
	}
	return v.(*byteutil.Buffer)
}

// free_buffer releases the byte buffer.
func free_buffer(buf *byteutil.Buffer) {
	if cap(buf.B) > int(^uint16(0)) {
		return // drop large bufs
	}
	buf_pool.Put(buf)
}