added stack_clear()

Author: Lord-KA

gstack-header.h

@@ -436,6 +436,15 @@ static stack_status GENERIC(stack_healthCheck)(const GENERIC(stack) *this_);
 static stack_status GENERIC(stack_dump)(const GENERIC(stack) *this_);
 
 
+/**
+ * @fn static stack_status stack_clear(const stack *this_)                  
+ * @brief destroys stack and creates a new one
+ * @param this_ pointer to stack
+ * @return bitset of stack status
+ */
+static stack_status GENERIC(stack_clear)(const GENERIC(stack) *this_);
+
+
 /**
  * @fn static stack_status stack_dumpToStream(const stack *this_, FILE *out)
  * @brief dumps stack structure and data into `out`

gstack.h

@@ -417,6 +417,16 @@ static stack_status GENERIC(stack_reallocate)(GENERIC(stack) *this_, const size_
 }
 
 
+static stack_status GENERIC(stack_clear)(GENERIC(stack) *this_)
+{
+    stack_status status = GENERIC(stack_dtor)(this_);
+    if (status != 0)
+        return status;
+    status = GENERIC(stack_ctor)(this_);
+    return status;
+}
+
+
 static stack_status GENERIC(stack_dumpToStream)(const GENERIC(stack) *this_, FILE *out)
 {
     STACK_PTR_VALIDATE(this_);

stack-test.cpp

@@ -236,6 +236,8 @@ TEST(PushGet, Random)
         }
     }
     EXPECT_EQ(S.len, STD.size());
+    GENERIC(stack_clear)(&S);
+    EXPECT_EQ(S.len, 0);
     GENERIC(stack_dtor)(&S);
 
 }