Add Reset capability for stacks

stack.go

@@ -287,6 +287,24 @@ func (r *stack) insert(x any, left int) (ok bool) {
 	return
 }
 
+/*
+Reset will silently iterate and delete each slice found within
+the receiver, leaving it unpopulated but still retaining its
+active configuration. Nothing is returned.
+*/
+func (r Stack) Reset() {
+	r.stack.reset()
+}
+
+/*
+reset is a private method called by Stack.Reset.
+*/
+func (r *stack) reset() {
+	for i := r.ulen(); i > 0; i-- {
+		r.remove(i - 1)
+	}
+}
+
 /*
 Remove will remove and return the Nth slice from the index,
 along with a success-indicative boolean value. A value of

stack_test.go

@@ -384,6 +384,25 @@ func TestBasic_withCapacity(t *testing.T) {
 	}
 }
 
+func TestReset(t *testing.T) {
+	b := Basic()
+	b.Push(
+		float64(3.14159),
+		float64(-9.378),
+		float64(139.104),
+	)
+	if b.Len() != 3 {
+		t.Errorf("%s failed: want '%d', got: '%d' [%s]", t.Name(), 3, b.Len(), b)
+	}
+
+	b.Reset()
+
+	if b.Len() != 0 {
+		sl, _ := b.Index(0)
+		t.Errorf("%s failed: want '%d', got: '%d' [%#v]", t.Name(), 0, b.Len(), sl)
+	}
+}
+
 func ExampleBasic() {
 	b := Basic()
 	b.Push(