RhodeCode

///\brief The concept of heaps.

    /// \brief The heap concept.

    /// Concept class describing the main interface of heaps.

    template <typename Priority, typename ItemIntMap>

      /// Type of the items stored in the heap.

      /// Type of the priorities.

      typedef Priority Prio;

      /// \brief Type to represent the states of the items.

      /// Each item has a state associated to it. It can be "in heap",

      /// "pre heap" or "post heap". The later two are indifferent

      /// from the point of view of the heap, but may be useful for

      /// the user.

      /// The \c ItemIntMap must be initialized in such a way, that it 

      /// assigns \c PRE_HEAP (<tt>-1</tt>) to every item.

      /// \param map A map that assigns \c int values to keys of type

      /// \c Item. It is used internally by the heap implementations to

      /// handle the cross references. The assigned value must be

      /// \c PRE_HEAP (<tt>-1</tt>) for every item.

      explicit Heap(ItemIntMap &map) {}

      /// \brief Checks if the heap is empty.

      /// Returns \c true if the heap is empty.

      /// \brief Makes the heap empty.

      /// Makes the heap empty.

      /// \brief Inserts an item into the heap with the given priority.

      /// Inserts the given item into the heap with the given priority. 

      /// \brief Returns the item having minimum priority.

      /// Returns the item having minimum priority.

      /// \pre The heap must be non-empty.

      /// \brief The minimum priority.

      /// Returns the minimum priority.

      /// \pre The heap must be non-empty.

      /// \brief Removes the item having minimum priority.

      /// Removes the item having minimum priority.

      /// \brief Removes an item from the heap.

      /// Removes the given item from the heap if it is already stored.

      /// \param i The item to delete. 

      /// \brief The priority of an item.

      /// Returns the priority of the given item.  

      /// \brief Sets the priority of an item or inserts it, if it is

      /// not stored in the heap.

      /// This method sets the priority of the given item if it is

      /// already stored in the heap.

      /// Otherwise it inserts the given item with the given priority.

      ///

      /// It may throw an \ref UnderflowPriorityException.

      /// \brief Decreases the priority of an item to the given value.

      /// Decreases the priority of an item to the given value.

      /// \brief Increases the priority of an item to the given value.

      /// Increases the priority of an item to the given value.

      /// \pre \c i must be stored in the heap with priority at most \c p.

      /// \brief Returns if an item is in, has already been in, or has

      /// This method returns \c PRE_HEAP if the given item has never

      /// been in the heap, \c IN_HEAP if it is in the heap at the moment,

      /// and \c POST_HEAP otherwise.

      /// In the latter case it is possible that the item will get back

      /// to the heap again.

      /// \brief Sets the state of an item in the heap.

      /// Sets the state of the given item in the heap. It can be used

      /// to manually clear the heap when it is important to achive the

	void constraints() {

	  typedef typename _Heap::Item OwnItem;

	  typedef typename _Heap::Prio OwnPrio;

	  typedef typename _Heap::State OwnState;

	  State state;

	  OwnItem own_item;

	  OwnPrio own_prio;

	  OwnState own_state;

	  own_item=Item();

	  own_prio=Prio();

	  ignore_unused_variable_warning(own_item);

	  ignore_unused_variable_warning(own_prio);

	  ignore_unused_variable_warning(own_state);

	  _Heap heap1(map);

	  _Heap heap2 = heap1;

	  ignore_unused_variable_warning(heap2);

	  int s = heap.size();

	  bool e = heap.empty();

	  prio = heap[item];

	  own_prio = heap.prio();

	  own_item = heap.top();

	  own_prio = heap[own_item];

	  heap.push(item, prio);

	  heap.push(own_item, own_prio);

	  heap.set(own_item, own_prio);

	  heap.decrease(own_item, own_prio);

	  heap.increase(own_item, own_prio);

	  heap.erase(own_item);

	  heap.clear();

	  heap.state(item, state);

	  state = heap.state(own_item);

	  heap.state(own_item, own_state);

	  own_state = _Heap::PRE_HEAP;

	  own_state = _Heap::IN_HEAP;

	  own_state = _Heap::POST_HEAP;