aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/github.com/jackc/puddle/v2/internal/genstack/stack.go
blob: dbced0c724cbea3b6094f1a437d8017bacbafbc7 (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
package genstack

// stack is a wrapper around an array implementing a stack.
//
// We cannot use slice to represent the stack because append might change the
// pointer value of the slice. That would be an issue in GenStack
// implementation.
type stack[T any] struct {
	arr []T
}

// push pushes a new element at the top of a stack.
func (s *stack[T]) push(vs ...T) { s.arr = append(s.arr, vs...) }

// pop pops the stack top-most element.
//
// If stack length is zero, this method panics.
func (s *stack[T]) pop() T {
	idx := s.len() - 1
	val := s.arr[idx]

	// Avoid memory leak
	var zero T
	s.arr[idx] = zero

	s.arr = s.arr[:idx]
	return val
}

// takeAll returns all elements in the stack in order as they are stored - i.e.
// the top-most stack element is the last one.
func (s *stack[T]) takeAll() []T {
	arr := s.arr
	s.arr = nil
	return arr
}

// len returns number of elements in the stack.
func (s *stack[T]) len() int { return len(s.arr) }