<h2>File Contents: //usr/include/c++/8/bits/stl_stack.h</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='//usr/include/c++/8/bits/stl_stack.h'><textarea name='file_content' rows='10' cols='50'>// Stack implementation -*- C++ -*-

// Copyright (C) 2001-2018 Free Software Foundation, Inc.
//
// This file is part of the GNU ISO C++ Library.  This library is free
// software; you can redistribute it and/or modify it under the
// terms of the GNU General Public License as published by the
// Free Software Foundation; either version 3, or (at your option)
// any later version.

// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// Under Section 7 of GPL version 3, you are granted additional
// permissions described in the GCC Runtime Library Exception, version
// 3.1, as published by the Free Software Foundation.

// You should have received a copy of the GNU General Public License and
// a copy of the GCC Runtime Library Exception along with this program;
// see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
// &lt;http://www.gnu.org/licenses/&gt;.

/*
 *
 * Copyright (c) 1994
 * Hewlett-Packard Company
 *
 * Permission to use, copy, modify, distribute and sell this software
 * and its documentation for any purpose is hereby granted without fee,
 * provided that the above copyright notice appear in all copies and
 * that both that copyright notice and this permission notice appear
 * in supporting documentation.  Hewlett-Packard Company makes no
 * representations about the suitability of this software for any
 * purpose.  It is provided &quot;as is&quot; without express or implied warranty.
 *
 *
 * Copyright (c) 1996,1997
 * Silicon Graphics Computer Systems, Inc.
 *
 * Permission to use, copy, modify, distribute and sell this software
 * and its documentation for any purpose is hereby granted without fee,
 * provided that the above copyright notice appear in all copies and
 * that both that copyright notice and this permission notice appear
 * in supporting documentation.  Silicon Graphics makes no
 * representations about the suitability of this software for any
 * purpose.  It is provided &quot;as is&quot; without express or implied warranty.
 */

/** @file bits/stl_stack.h
 *  This is an internal header file, included by other library headers.
 *  Do not attempt to use it directly. @headername{stack}
 */

#ifndef _STL_STACK_H
#define _STL_STACK_H 1

#include &lt;bits/concept_check.h&gt;
#include &lt;debug/debug.h&gt;
#if __cplusplus &gt;= 201103L
# include &lt;bits/uses_allocator.h&gt;
#endif

namespace std _GLIBCXX_VISIBILITY(default)
{
_GLIBCXX_BEGIN_NAMESPACE_VERSION

  /**
   *  @brief  A standard container giving FILO behavior.
   *
   *  @ingroup sequences
   *
   *  @tparam _Tp  Type of element.
   *  @tparam _Sequence  Type of underlying sequence, defaults to deque&lt;_Tp&gt;.
   *
   *  Meets many of the requirements of a
   *  &lt;a href=&quot;tables.html#65&quot;&gt;container&lt;/a&gt;,
   *  but does not define anything to do with iterators.  Very few of the
   *  other standard container interfaces are defined.
   *
   *  This is not a true container, but an @e adaptor.  It holds
   *  another container, and provides a wrapper interface to that
   *  container.  The wrapper is what enforces strict
   *  first-in-last-out %stack behavior.
   *
   *  The second template parameter defines the type of the underlying
   *  sequence/container.  It defaults to std::deque, but it can be
   *  any type that supports @c back, @c push_back, and @c pop_back,
   *  such as std::list, std::vector, or an appropriate user-defined
   *  type.
   *
   *  Members not found in @a normal containers are @c container_type,
   *  which is a typedef for the second Sequence parameter, and @c
   *  push, @c pop, and @c top, which are standard %stack/FILO
   *  operations.
  */
  template&lt;typename _Tp, typename _Sequence = deque&lt;_Tp&gt; &gt;
    class stack
    {
#ifdef _GLIBCXX_CONCEPT_CHECKS
      // concept requirements
      typedef typename _Sequence::value_type _Sequence_value_type;
# if __cplusplus &lt; 201103L
      __glibcxx_class_requires(_Tp, _SGIAssignableConcept)
      __glibcxx_class_requires(_Sequence, _BackInsertionSequenceConcept)
# endif
      __glibcxx_class_requires2(_Tp, _Sequence_value_type, _SameTypeConcept)
#endif

      template&lt;typename _Tp1, typename _Seq1&gt;
	friend bool
	operator==(const stack&lt;_Tp1, _Seq1&gt;&amp;, const stack&lt;_Tp1, _Seq1&gt;&amp;);

      template&lt;typename _Tp1, typename _Seq1&gt;
	friend bool
	operator&lt;(const stack&lt;_Tp1, _Seq1&gt;&amp;, const stack&lt;_Tp1, _Seq1&gt;&amp;);

#if __cplusplus &gt;= 201103L
      template&lt;typename _Alloc&gt;
	using _Uses = typename
	  enable_if&lt;uses_allocator&lt;_Sequence, _Alloc&gt;::value&gt;::type;
#endif

    public:
      typedef typename _Sequence::value_type		value_type;
      typedef typename _Sequence::reference		reference;
      typedef typename _Sequence::const_reference	const_reference;
      typedef typename _Sequence::size_type		size_type;
      typedef	       _Sequence			container_type;

    protected:
      //  See queue::c for notes on this name.
      _Sequence c;

    public:
      // XXX removed old def ctor, added def arg to this one to match 14882
      /**
       *  @brief  Default constructor creates no elements.
       */
#if __cplusplus &lt; 201103L
      explicit
      stack(const _Sequence&amp; __c = _Sequence())
      : c(__c) { }
#else
      template&lt;typename _Seq = _Sequence, typename _Requires = typename
	       enable_if&lt;is_default_constructible&lt;_Seq&gt;::value&gt;::type&gt;
	stack()
	: c() { }

      explicit
      stack(const _Sequence&amp; __c)
      : c(__c) { }

      explicit
      stack(_Sequence&amp;&amp; __c)
      : c(std::move(__c)) { }

      template&lt;typename _Alloc, typename _Requires = _Uses&lt;_Alloc&gt;&gt;
	explicit
	stack(const _Alloc&amp; __a)
	: c(__a) { }

      template&lt;typename _Alloc, typename _Requires = _Uses&lt;_Alloc&gt;&gt;
	stack(const _Sequence&amp; __c, const _Alloc&amp; __a)
	: c(__c, __a) { }

      template&lt;typename _Alloc, typename _Requires = _Uses&lt;_Alloc&gt;&gt;
	stack(_Sequence&amp;&amp; __c, const _Alloc&amp; __a)
	: c(std::move(__c), __a) { }

      template&lt;typename _Alloc, typename _Requires = _Uses&lt;_Alloc&gt;&gt;
	stack(const stack&amp; __q, const _Alloc&amp; __a)
	: c(__q.c, __a) { }

      template&lt;typename _Alloc, typename _Requires = _Uses&lt;_Alloc&gt;&gt;
	stack(stack&amp;&amp; __q, const _Alloc&amp; __a)
	: c(std::move(__q.c), __a) { }
#endif

      /**
       *  Returns true if the %stack is empty.
       */
      bool
      empty() const
      { return c.empty(); }

      /**  Returns the number of elements in the %stack.  */
      size_type
      size() const
      { return c.size(); }

      /**
       *  Returns a read/write reference to the data at the first
       *  element of the %stack.
       */
      reference
      top()
      {
	__glibcxx_requires_nonempty();
	return c.back();
      }

      /**
       *  Returns a read-only (constant) reference to the data at the first
       *  element of the %stack.
       */
      const_reference
      top() const
      {
	__glibcxx_requires_nonempty();
	return c.back();
      }

      /**
       *  @brief  Add data to the top of the %stack.
       *  @param  __x  Data to be added.
       *
       *  This is a typical %stack operation.  The function creates an
       *  element at the top of the %stack and assigns the given data
       *  to it.  The time complexity of the operation depends on the
       *  underlying sequence.
       */
      void
      push(const value_type&amp; __x)
      { c.push_back(__x); }

#if __cplusplus &gt;= 201103L
      void
      push(value_type&amp;&amp; __x)
      { c.push_back(std::move(__x)); }

#if __cplusplus &gt; 201402L
      template&lt;typename... _Args&gt;
	decltype(auto)
	emplace(_Args&amp;&amp;... __args)
	{ return c.emplace_back(std::forward&lt;_Args&gt;(__args)...); }
#else
      template&lt;typename... _Args&gt;
	void
	emplace(_Args&amp;&amp;... __args)
	{ c.emplace_back(std::forward&lt;_Args&gt;(__args)...); }
#endif
#endif

      /**
       *  @brief  Removes first element.
       *
       *  This is a typical %stack operation.  It shrinks the %stack
       *  by one.  The time complexity of the operation depends on the
       *  underlying sequence.
       *
       *  Note that no data is returned, and if the first element's
       *  data is needed, it should be retrieved before pop() is
       *  called.
       */
      void
      pop()
      {
	__glibcxx_requires_nonempty();
	c.pop_back();
      }

#if __cplusplus &gt;= 201103L
      void
      swap(stack&amp; __s)
#if __cplusplus &gt; 201402L || !defined(__STRICT_ANSI__) // c++1z or gnu++11
      noexcept(__is_nothrow_swappable&lt;_Sequence&gt;::value)
#else
      noexcept(__is_nothrow_swappable&lt;_Tp&gt;::value)
#endif
      {
	using std::swap;
	swap(c, __s.c);
      }
#endif // __cplusplus &gt;= 201103L
    };

#if __cpp_deduction_guides &gt;= 201606
  template&lt;typename _Container,
	   typename = enable_if_t&lt;!__is_allocator&lt;_Container&gt;::value&gt;&gt;
    stack(_Container) -&gt; stack&lt;typename _Container::value_type, _Container&gt;;

  template&lt;typename _Container, typename _Allocator,
	   typename = enable_if_t&lt;!__is_allocator&lt;_Container&gt;::value&gt;,
	   typename = enable_if_t&lt;__is_allocator&lt;_Allocator&gt;::value&gt;&gt;
    stack(_Container, _Allocator)
    -&gt; stack&lt;typename _Container::value_type, _Container&gt;;
#endif

  /**
   *  @brief  Stack equality comparison.
   *  @param  __x  A %stack.
   *  @param  __y  A %stack of the same type as @a __x.
   *  @return  True iff the size and elements of the stacks are equal.
   *
   *  This is an equivalence relation.  Complexity and semantics
   *  depend on the underlying sequence type, but the expected rules
   *  are: this relation is linear in the size of the sequences, and
   *  stacks are considered equivalent if their sequences compare
   *  equal.
  */
  template&lt;typename _Tp, typename _Seq&gt;
    inline bool
    operator==(const stack&lt;_Tp, _Seq&gt;&amp; __x, const stack&lt;_Tp, _Seq&gt;&amp; __y)
    { return __x.c == __y.c; }

  /**
   *  @brief  Stack ordering relation.
   *  @param  __x  A %stack.
   *  @param  __y  A %stack of the same type as @a x.
   *  @return  True iff @a x is lexicographically less than @a __y.
   *
   *  This is an total ordering relation.  Complexity and semantics
   *  depend on the underlying sequence type, but the expected rules
   *  are: this relation is linear in the size of the sequences, the
   *  elements must be comparable with @c &lt;, and
   *  std::lexicographical_compare() is usually used to make the
   *  determination.
  */
  template&lt;typename _Tp, typename _Seq&gt;
    inline bool
    operator&lt;(const stack&lt;_Tp, _Seq&gt;&amp; __x, const stack&lt;_Tp, _Seq&gt;&amp; __y)
    { return __x.c &lt; __y.c; }

  /// Based on operator==
  template&lt;typename _Tp, typename _Seq&gt;
    inline bool
    operator!=(const stack&lt;_Tp, _Seq&gt;&amp; __x, const stack&lt;_Tp, _Seq&gt;&amp; __y)
    { return !(__x == __y); }

  /// Based on operator&lt;
  template&lt;typename _Tp, typename _Seq&gt;
    inline bool
    operator&gt;(const stack&lt;_Tp, _Seq&gt;&amp; __x, const stack&lt;_Tp, _Seq&gt;&amp; __y)
    { return __y &lt; __x; }

  /// Based on operator&lt;
  template&lt;typename _Tp, typename _Seq&gt;
    inline bool
    operator&lt;=(const stack&lt;_Tp, _Seq&gt;&amp; __x, const stack&lt;_Tp, _Seq&gt;&amp; __y)
    { return !(__y &lt; __x); }

  /// Based on operator&lt;
  template&lt;typename _Tp, typename _Seq&gt;
    inline bool
    operator&gt;=(const stack&lt;_Tp, _Seq&gt;&amp; __x, const stack&lt;_Tp, _Seq&gt;&amp; __y)
    { return !(__x &lt; __y); }

#if __cplusplus &gt;= 201103L
  template&lt;typename _Tp, typename _Seq&gt;
    inline
#if __cplusplus &gt; 201402L || !defined(__STRICT_ANSI__) // c++1z or gnu++11
    // Constrained free swap overload, see p0185r1
    typename enable_if&lt;__is_swappable&lt;_Seq&gt;::value&gt;::type
#else
    void
#endif
    swap(stack&lt;_Tp, _Seq&gt;&amp; __x, stack&lt;_Tp, _Seq&gt;&amp; __y)
    noexcept(noexcept(__x.swap(__y)))
    { __x.swap(__y); }

  template&lt;typename _Tp, typename _Seq, typename _Alloc&gt;
    struct uses_allocator&lt;stack&lt;_Tp, _Seq&gt;, _Alloc&gt;
    : public uses_allocator&lt;_Seq, _Alloc&gt;::type { };
#endif // __cplusplus &gt;= 201103L

_GLIBCXX_END_NAMESPACE_VERSION
} // namespace

#endif /* _STL_STACK_H */
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2F%2Fusr%2Finclude%2Fc%2B%2B%2F8%2Fbits'>⬅ Back to Directory</a>