stack

type IStack[T any] interface {
	// Push adds elements to the stack.
	Push(value ...T)
	// PushSequence adds elements to the stack.
	PushSequence(seq iter.Seq[T])
	// Pop removes and returns an element from the stack. Returns ok true if the stack is not empty.
	Pop() (element T, ok bool)
	// Peek returns the element at the top of the stack without removing it.
	Peek() (element T, ok bool)
	// IsEmpty states whether the stack is empty. Returns ok true if the stack is not empty.
	IsEmpty() bool
	// Clear clears all elements from the stack.
	Clear()
	// Values returns all the elements in the stack. The stack will be empty as a result.
	Values() iter.Seq[T]
	// Len returns the number of elements in the stack.
	Len() int
}

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

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