stack

package

v0.0.28 Latest Latest Go to latest Published: Mar 1, 2026 License: MIT Imports: 0 Imported by: 0

Details

Package stack provides reusable stack helpers for validation/runtime state.

This section is empty.

This section is empty.

This section is empty.

type Stack[T any] struct {
	// contains filtered or unexported fields
}

Stack is a reusable LIFO stack for validation state.

func NewStack[T any](capacity int) Stack[T]

NewStack creates a stack with an optional capacity hint.

func (s *Stack[T]) Cap() int

Cap reports the underlying slice capacity.

func (s *Stack[T]) Drop()

Drop clears the stack and releases backing storage.

func (s *Stack[T]) Items() []T

Items returns the stack backing slice in push order.

func (s *Stack[T]) Len() int

Len reports the current stack depth.

func (s *Stack[T]) Peek() (T, bool)

Peek returns the top value without removing it.

func (s *Stack[T]) Pop() (T, bool)

Pop removes and returns the top value.

func (s *Stack[T]) Push(value T)

Push adds one value to the stack top.

func (s *Stack[T]) Reset()

Reset clears the stack while retaining capacity.