llindexedqueue.h
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:4k
源码类别:

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file llindexedqueue.h
  3.  * @brief An indexed FIFO queue, where only one element with each key
  4.  * can be in the queue.
  5.  *
  6.  * $LicenseInfo:firstyear=2003&license=viewergpl$
  7.  * 
  8.  * Copyright (c) 2003-2010, Linden Research, Inc.
  9.  * 
  10.  * Second Life Viewer Source Code
  11.  * The source code in this file ("Source Code") is provided by Linden Lab
  12.  * to you under the terms of the GNU General Public License, version 2.0
  13.  * ("GPL"), unless you have obtained a separate licensing agreement
  14.  * ("Other License"), formally executed by you and Linden Lab.  Terms of
  15.  * the GPL can be found in doc/GPL-license.txt in this distribution, or
  16.  * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
  17.  * 
  18.  * There are special exceptions to the terms and conditions of the GPL as
  19.  * it is applied to this Source Code. View the full text of the exception
  20.  * in the file doc/FLOSS-exception.txt in this software distribution, or
  21.  * online at
  22.  * http://secondlifegrid.net/programs/open_source/licensing/flossexception
  23.  * 
  24.  * By copying, modifying or distributing this software, you acknowledge
  25.  * that you have read and understood your obligations described above,
  26.  * and agree to abide by those obligations.
  27.  * 
  28.  * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
  29.  * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
  30.  * COMPLETENESS OR PERFORMANCE.
  31.  * $/LicenseInfo$
  32.  */
  33. #ifndef LL_LLINDEXEDQUEUE_H
  34. #define LL_LLINDEXEDQUEUE_H
  35. // An indexed FIFO queue, where only one element with each key can be in the queue.
  36. // This is ONLY used in the interest list, you'll probably want to review this code
  37. // carefully if you want to use it elsewhere - Doug
  38. template <typename Type> 
  39. class LLIndexedQueue
  40. {
  41. protected:
  42. typedef std::deque<Type> type_deque;
  43. type_deque mQueue;
  44. std::set<Type> mKeySet;
  45. public:
  46. LLIndexedQueue() {}
  47. // move_if_there is an O(n) operation
  48. bool push_back(const Type &value, bool move_if_there = false)
  49. {
  50. if (mKeySet.find(value) != mKeySet.end())
  51. {
  52. // Already on the queue
  53. if (move_if_there)
  54. {
  55. // Remove the existing entry.
  56. typename type_deque::iterator it;
  57. for (it = mQueue.begin(); it != mQueue.end(); ++it)
  58. {
  59. if (*it == value)
  60. {
  61. break;
  62. }
  63. }
  64. // This HAS to succeed, otherwise there's a serious bug in the keyset implementation
  65. // (although this isn't thread safe, at all)
  66. mQueue.erase(it);
  67. }
  68. else
  69. {
  70. // We're not moving it, leave it alone
  71. return false;
  72. }
  73. }
  74. else
  75. {
  76. // Doesn't exist, add it to the key set
  77. mKeySet.insert(value);
  78. }
  79. mQueue.push_back(value);
  80. // We succeeded in adding the new element.
  81. return true;
  82. }
  83. bool push_front(const Type &value, bool move_if_there = false)
  84. {
  85. if (mKeySet.find(value) != mKeySet.end())
  86. {
  87. // Already on the queue
  88. if (move_if_there)
  89. {
  90. // Remove the existing entry.
  91. typename type_deque::iterator it;
  92. for (it = mQueue.begin(); it != mQueue.end(); ++it)
  93. {
  94. if (*it == value)
  95. {
  96. break;
  97. }
  98. }
  99. // This HAS to succeed, otherwise there's a serious bug in the keyset implementation
  100. // (although this isn't thread safe, at all)
  101. mQueue.erase(it);
  102. }
  103. else
  104. {
  105. // We're not moving it, leave it alone
  106. return false;
  107. }
  108. }
  109. else
  110. {
  111. // Doesn't exist, add it to the key set
  112. mKeySet.insert(value);
  113. }
  114. mQueue.push_front(value);
  115. return true;
  116. }
  117. void pop()
  118. {
  119. Type value = mQueue.front();
  120. mKeySet.erase(value);
  121. mQueue.pop_front();
  122. }
  123. Type &front()
  124. {
  125. return mQueue.front();
  126. }
  127. S32 size() const
  128. {
  129. return mQueue.size();
  130. }
  131. bool empty() const
  132. {
  133. return mQueue.empty();
  134. }
  135. void clear()
  136. {
  137. // Clear out all elements on the queue
  138. mQueue.clear();
  139. mKeySet.clear();
  140. }
  141. };
  142. #endif // LL_LLINDEXEDQUEUE_H