aboutsummaryrefslogtreecommitdiff
path: root/vendor/github.com/jackc/puddle/v2/internal/genstack/gen_stack.go
blob: 7e4660c8c0ce765a0a02939f1197aabc562db359 (plain) (blame)
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 genstack

// GenStack implements a generational stack.
//
// GenStack works as common stack except for the fact that all elements in the
// older generation are guaranteed to be popped before any element in the newer
// generation. New elements are always pushed to the current (newest)
// generation.
//
// We could also say that GenStack behaves as a stack in case of a single
// generation, but it behaves as a queue of individual generation stacks.
type GenStack[T any] struct {
	// We can represent arbitrary number of generations using 2 stacks. The
	// new stack stores all new pushes and the old stack serves all reads.
	// Old stack can represent multiple generations. If old == new, then all
	// elements pushed in previous (not current) generations have already
	// been popped.

	old *stack[T]
	new *stack[T]
}

// NewGenStack creates a new empty GenStack.
func NewGenStack[T any]() *GenStack[T] {
	s := &stack[T]{}
	return &GenStack[T]{
		old: s,
		new: s,
	}
}

func (s *GenStack[T]) Pop() (T, bool) {
	// Pushes always append to the new stack, so if the old once becomes
	// empty, it will remail empty forever.
	if s.old.len() == 0 && s.old != s.new {
		s.old = s.new
	}

	if s.old.len() == 0 {
		var zero T
		return zero, false
	}

	return s.old.pop(), true
}

// Push pushes a new element at the top of the stack.
func (s *GenStack[T]) Push(v T) { s.new.push(v) }

// NextGen starts a new stack generation.
func (s *GenStack[T]) NextGen() {
	if s.old == s.new {
		s.new = &stack[T]{}
		return
	}

	// We need to pop from the old stack to the top of the new stack. Let's
	// have an example:
	//
	//   Old: <bottom> 4 3 2 1
	//   New: <bottom> 8 7 6 5
	//   PopOrder: 1 2 3 4 5 6 7 8
	//
	//
	// To preserve pop order, we have to take all elements from the old
	// stack and push them to the top of new stack:
	//
	//   New: 8 7 6 5 4 3 2 1
	//
	s.new.push(s.old.takeAll()...)

	// We have the old stack allocated and empty, so why not to reuse it as
	// new new stack.
	s.old, s.new = s.new, s.old
}

// Len returns number of elements in the stack.
func (s *GenStack[T]) Len() int {
	l := s.old.len()
	if s.old != s.new {
		l += s.new.len()
	}

	return l
}