add Chapter17

Chapter17/fsm/libs/etl/include/etl/debug_count.h

@@ -0,0 +1,180 @@
+///\file
+
+/******************************************************************************
+The MIT License(MIT)
+
+Embedded Template Library.
+https://github.com/ETLCPP/etl
+https://www.etlcpp.com
+
+Copyright(c) 2017 John Wellbelove
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files(the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions :
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+******************************************************************************/
+
+#ifndef ETL_DEBUG_COUNT_INCLUDED
+#define ETL_DEBUG_COUNT_INCLUDED
+
+#include "platform.h"
+#include "atomic.h"
+
+#include <assert.h>
+#include <stdint.h>
+
+///\defgroup debug_count debug count
+///\ingroup utilities
+
+#if defined(ETL_DEBUG_COUNT)
+
+  #define ETL_DECLARE_DEBUG_COUNT              etl::debug_count etl_debug_count
+  #define ETL_SET_DEBUG_COUNT(n)               etl_debug_count.set(n)
+  #define ETL_GET_DEBUG_COUNT                  etl_debug_count.get()
+  #define ETL_INCREMENT_DEBUG_COUNT            ++etl_debug_count
+  #define ETL_DECREMENT_DEBUG_COUNT            --etl_debug_count
+  #define ETL_ADD_DEBUG_COUNT(n)               etl_debug_count += (n)
+  #define ETL_SUBTRACT_DEBUG_COUNT(n)          etl_debug_count -= (n)
+  #define ETL_RESET_DEBUG_COUNT                etl_debug_count.clear()
+  #define ETL_OBJECT_RESET_DEBUG_COUNT(object) object.etl_debug_count.clear()
+  #define ETL_OBJECT_GET_DEBUG_COUNT(object)   object.etl_debug_count.get()
+
+namespace etl
+{
+  //***************************************************************************
+  /// Used to count instances.
+  /// Asserts if the count is decremented below zero.
+  /// Asserts if the count is not zero when destructed.
+  /// Does nothing in a non-debug build.
+  ///\ingroup reference
+  //***************************************************************************
+  class debug_count
+  {
+  public:
+    debug_count()
+      : count(0)
+    {
+    }
+
+    ~debug_count()
+    {
+      assert(count == 0);
+    }
+
+    debug_count& operator++()
+    {
+      ++count;
+      return *this;
+    }
+
+    debug_count& operator--()
+    {
+      --count;
+      assert(count >= 0);
+      return *this;
+    }
+
+    template <typename T>
+    debug_count& operator+=(T n)
+    {
+      count += int32_t(n);
+      return *this;
+    }
+
+    template <typename T>
+    debug_count& operator-=(T n)
+    {
+      count -= int32_t(n);
+      return *this;
+    }
+
+    debug_count& operator=(const debug_count& other)
+    {
+      count.store(other.count.load());
+
+      return *this;
+    }
+
+  #if ETL_HAS_ATOMIC
+    void swap(debug_count& other) ETL_NOEXCEPT  // NOT ATOMIC
+    {
+      int32_t temp = other.count.load();
+      other.count.store(count.load());
+      count.store(temp);
+    }
+  #else
+    void swap(debug_count& other) ETL_NOEXCEPT
+    {
+      swap(count, other.count);
+    }
+  #endif
+
+    operator int32_t() const
+    {
+      return count;
+    }
+
+    int32_t get() const
+    {
+      return int32_t(count);
+    }
+
+    void set(int32_t n)
+    {
+      count = n;
+    }
+
+    void clear()
+    {
+      count = 0;
+    }
+
+  private:
+  #if ETL_HAS_ATOMIC
+    etl::atomic_int32_t count;
+  #else
+    int32_t count;
+  #endif
+  };
+}  // namespace etl
+
+inline void swap(etl::debug_count& lhs, etl::debug_count& rhs)
+{
+  lhs.swap(rhs);
+}
+
+#else
+  #define ETL_DECLARE_DEBUG_COUNT              etl::debug_count etl_debug_count
+  #define ETL_SET_DEBUG_COUNT(n)               ETL_DO_NOTHING
+  #define ETL_GET_DEBUG_COUNT                  ETL_DO_NOTHING
+  #define ETL_INCREMENT_DEBUG_COUNT            ETL_DO_NOTHING
+  #define ETL_DECREMENT_DEBUG_COUNT            ETL_DO_NOTHING
+  #define ETL_ADD_DEBUG_COUNT(n)               ETL_DO_NOTHING
+  #define ETL_SUBTRACT_DEBUG_COUNT(n)          ETL_DO_NOTHING
+  #define ETL_RESET_DEBUG_COUNT                ETL_DO_NOTHING
+  #define ETL_OBJECT_RESET_DEBUG_COUNT(object) ETL_DO_NOTHING
+  #define ETL_OBJECT_GET_DEBUG_COUNT(object)   ETL_DO_NOTHING
+
+namespace etl
+{
+  class debug_count
+  {
+  };
+}
+#endif  // ETL_DEBUG_COUNT
+
+#endif