diff options
Diffstat (limited to 'include/EASTL/stack.h')
| -rw-r--r-- | include/EASTL/stack.h | 346 |
1 files changed, 346 insertions, 0 deletions
diff --git a/include/EASTL/stack.h b/include/EASTL/stack.h new file mode 100644 index 0000000..3edd5f5 --- /dev/null +++ b/include/EASTL/stack.h @@ -0,0 +1,346 @@ +/////////////////////////////////////////////////////////////////////////////// +// Copyright (c) Electronic Arts Inc. All rights reserved. +/////////////////////////////////////////////////////////////////////////////// + +/////////////////////////////////////////////////////////////////////////////// +// This file implements a stack that is just like the C++ std::stack adapter class. +// The only significant difference is that the stack here provides a get_container +// function to provide access to the underlying container. +/////////////////////////////////////////////////////////////////////////////// + + +#ifndef EASTL_STACK_H +#define EASTL_STACK_H + + +#include <EASTL/internal/config.h> +#include <EASTL/vector.h> +#include <EASTL/initializer_list.h> +#include <stddef.h> + +#if defined(EA_PRAGMA_ONCE_SUPPORTED) + #pragma once // Some compilers (e.g. VC++) benefit significantly from using this. We've measured 3-4% build speed improvements in apps as a result. +#endif + + + +namespace eastl +{ + + /// EASTL_STACK_DEFAULT_NAME + /// + /// Defines a default container name in the absence of a user-provided name. + /// + #ifndef EASTL_STACK_DEFAULT_NAME + #define EASTL_STACK_DEFAULT_NAME EASTL_DEFAULT_NAME_PREFIX " stack" // Unless the user overrides something, this is "EASTL stack". + #endif + + /// EASTL_STACK_DEFAULT_ALLOCATOR + /// + #ifndef EASTL_STACK_DEFAULT_ALLOCATOR + #define EASTL_STACK_DEFAULT_ALLOCATOR allocator_type(EASTL_STACK_DEFAULT_NAME) + #endif + + + + /// stack + /// + /// stack is an adapter class provides a LIFO (last-in, first-out) interface + /// via wrapping a sequence that provides at least the following operations: + /// push_back + /// pop_back + /// back + /// + /// In practice this means vector, deque, string, list, intrusive_list. + /// + template <typename T, typename Container = eastl::vector<T> > + class stack + { + public: + typedef stack<T, Container> this_type; + typedef Container container_type; + //typedef typename Container::allocator_type allocator_type; // We can't currently declare this because the container may be a type that doesn't have an allocator. + typedef typename Container::value_type value_type; + typedef typename Container::reference reference; + typedef typename Container::const_reference const_reference; + typedef typename Container::size_type size_type; + + public: // We declare public so that global comparison operators can be implemented without adding an inline level and without tripping up GCC 2.x friend declaration failures. GCC (through at least v4.0) is poor at inlining and performance wins over correctness. + container_type c; // The C++ standard specifies that you declare a protected member variable of type Container called 'c'. + + public: + stack(); + + // Allocator is templated here because we aren't allowed to infer the allocator_type from the Container, as some containers (e.g. array) don't + // have allocators. For containers that don't have allocator types, you could use void or char as the Allocator template type. + + template <class Allocator> + explicit stack(const Allocator& allocator, typename eastl::enable_if<eastl::uses_allocator<container_type, Allocator>::value>::type* = NULL) + : c(allocator) + { + } + + template <class Allocator> + stack(const this_type& x, const Allocator& allocator, typename eastl::enable_if<eastl::uses_allocator<container_type, Allocator>::value>::type* = NULL) + : c(x.c, allocator) + { + } + + template <class Allocator> + stack(this_type&& x, const Allocator& allocator, typename eastl::enable_if<eastl::uses_allocator<container_type, Allocator>::value>::type* = NULL) + : c(eastl::move(x.c), allocator) + { + } + + explicit stack(const container_type& x); + explicit stack(container_type&& x); + + // Additional C++11 support to consider: + // + // template <class Allocator> + // stack(const container_type& x, const Allocator& allocator); + // + // template <class Allocator> + // stack(container_type&& x, const Allocator& allocator); + + stack(std::initializer_list<value_type> ilist); // The first item in the initializer list is pushed first. C++11 doesn't specify that std::stack has initializer list support. + + bool empty() const; + size_type size() const; + + reference top(); + const_reference top() const; + + void push(const value_type& value); + void push(value_type&& x); + + template <class... Args> void emplace_back(Args&&... args); // backwards compatibility + template <class... Args> decltype(auto) emplace(Args&&... args); + + void pop(); + + container_type& get_container(); + const container_type& get_container() const; + + void swap(this_type& x) EA_NOEXCEPT_IF(eastl::is_nothrow_swappable<this_type::container_type>::value); + + bool validate() const; + + }; // class stack + + + + + + /////////////////////////////////////////////////////////////////////// + // stack + /////////////////////////////////////////////////////////////////////// + + template <typename T, typename Container> + inline stack<T, Container>::stack() + : c() // To consider: use c(EASTL_STACK_DEFAULT_ALLOCATOR) here, though that would add the requirement that the user supplied container support this. + { + // Empty + } + + + template <typename T, typename Container> + inline stack<T, Container>::stack(const Container& x) + : c(x) + { + // Empty + } + + + template <typename T, typename Container> + inline stack<T, Container>::stack(Container&& x) + : c(eastl::move(x)) + { + // Empty + } + + + template <typename T, typename Container> + inline stack<T, Container>::stack(std::initializer_list<value_type> ilist) + : c() // We could alternatively use c(ilist) here, but that would require c to have an ilist constructor. + { + // Better solution but requires an insert function. + // c.insert(ilist.begin(), ilist.end()); + + // Possibly slower solution but doesn't require an insert function. + for(const auto& value : ilist) + { + c.push_back(value); + } + } + + template <typename T, typename Container> + inline bool stack<T, Container>::empty() const + { + return c.empty(); + } + + + template <typename T, typename Container> + inline typename stack<T, Container>::size_type + stack<T, Container>::size() const + { + return c.size(); + } + + + template <typename T, typename Container> + inline typename stack<T, Container>::reference + stack<T, Container>::top() + { + return c.back(); + } + + + template <typename T, typename Container> + inline typename stack<T, Container>::const_reference + stack<T, Container>::top() const + { + return c.back(); + } + + + template <typename T, typename Container> + inline void stack<T, Container>::push(const value_type& value) + { + c.push_back(const_cast<value_type&>(value)); // const_cast so that intrusive_list can work. We may revisit this. + } + + + template <typename T, typename Container> + inline void stack<T, Container>::push(value_type&& x) + { + c.push_back(eastl::move(x)); + } + + + template <typename T, typename Container> + template <class... Args> + inline void stack<T, Container>::emplace_back(Args&&... args) + { + emplace(eastl::forward<Args>(args)...); + } + + + template <typename T, typename Container> + template <class... Args> + inline decltype(auto) stack<T, Container>::emplace(Args&&... args) + { + return c.emplace_back(eastl::forward<Args>(args)...); + } + + + template <typename T, typename Container> + inline void stack<T, Container>::pop() + { + c.pop_back(); + } + + + template <typename T, typename Container> + inline typename stack<T, Container>::container_type& + stack<T, Container>::get_container() + { + return c; + } + + + template <typename T, typename Container> + inline const typename stack<T, Container>::container_type& + stack<T, Container>::get_container() const + { + return c; + } + + + template <typename T, typename Container> + void stack<T, Container>::swap(this_type& x) EA_NOEXCEPT_IF(eastl::is_nothrow_swappable<this_type::container_type>::value) + { + using eastl::swap; + swap(c, x.c); + } + + + template <typename T, typename Container> + bool stack<T, Container>::validate() const + { + return c.validate(); + } + + + + /////////////////////////////////////////////////////////////////////// + // global operators + /////////////////////////////////////////////////////////////////////// + + template <typename T, typename Container> + inline bool operator==(const stack<T, Container>& a, const stack<T, Container>& b) + { + return (a.c == b.c); + } + + + template <typename T, typename Container> + inline bool operator!=(const stack<T, Container>& a, const stack<T, Container>& b) + { + return !(a.c == b.c); + } + + + template <typename T, typename Container> + inline bool operator<(const stack<T, Container>& a, const stack<T, Container>& b) + { + return (a.c < b.c); + } + + + template <typename T, typename Container> + inline bool operator>(const stack<T, Container>& a, const stack<T, Container>& b) + { + return (b.c < a.c); + } + + + template <typename T, typename Container> + inline bool operator<=(const stack<T, Container>& a, const stack<T, Container>& b) + { + return !(b.c < a.c); + } + + + template <typename T, typename Container> + inline bool operator>=(const stack<T, Container>& a, const stack<T, Container>& b) + { + return !(a.c < b.c); + } + + + template <typename T, typename Container> + inline void swap(stack<T, Container>& a, stack<T, Container>& b) EA_NOEXCEPT_IF((eastl::is_nothrow_swappable<typename stack<T, Container>::container_type>::value)) + { + a.swap(b); + } + + +} // namespace eastl + + +#endif // Header include guard + + + + + + + + + + + + + |