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

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file llstringtable.h
  3.  * @brief The LLStringTable class provides a _fast_ method for finding
  4.  * unique copies of strings.
  5.  *
  6.  * $LicenseInfo:firstyear=2001&license=viewergpl$
  7.  * 
  8.  * Copyright (c) 2001-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_STRING_TABLE_H
  34. #define LL_STRING_TABLE_H
  35. #include "lldefs.h"
  36. #include "llformat.h"
  37. #include "llstl.h"
  38. #include <list>
  39. #include <set>
  40. #if LL_WINDOWS
  41. # if (_MSC_VER >= 1300 && _MSC_VER < 1400)
  42. #  define STRING_TABLE_HASH_MAP 1
  43. # endif
  44. #else
  45. //# define STRING_TABLE_HASH_MAP 1
  46. #endif
  47. #if STRING_TABLE_HASH_MAP
  48. # if LL_WINDOWS
  49. #  include <hash_map>
  50. # else
  51. #  include <ext/hash_map>
  52. # endif
  53. #endif
  54. const U32 MAX_STRINGS_LENGTH = 256;
  55. class LL_COMMON_API LLStringTableEntry
  56. {
  57. public:
  58. LLStringTableEntry(const char *str);
  59. ~LLStringTableEntry();
  60. void incCount() { mCount++; }
  61. BOOL decCount() { return --mCount; }
  62. char *mString;
  63. S32  mCount;
  64. };
  65. class LL_COMMON_API LLStringTable
  66. {
  67. public:
  68. LLStringTable(int tablesize);
  69. ~LLStringTable();
  70. char *checkString(const char *str);
  71. char *checkString(const std::string& str);
  72. LLStringTableEntry *checkStringEntry(const char *str);
  73. LLStringTableEntry *checkStringEntry(const std::string& str);
  74. char *addString(const char *str);
  75. char *addString(const std::string& str);
  76. LLStringTableEntry *addStringEntry(const char *str);
  77. LLStringTableEntry *addStringEntry(const std::string& str);
  78. void  removeString(const char *str);
  79. S32 mMaxEntries;
  80. S32 mUniqueEntries;
  81. #if STRING_TABLE_HASH_MAP
  82. #if LL_WINDOWS
  83. typedef std::hash_multimap<U32, LLStringTableEntry *> string_hash_t;
  84. #else
  85. typedef __gnu_cxx::hash_multimap<U32, LLStringTableEntry *> string_hash_t;
  86. #endif
  87. string_hash_t mStringHash;
  88. #else
  89. typedef std::list<LLStringTableEntry *> string_list_t;
  90. typedef string_list_t * string_list_ptr_t;
  91. string_list_ptr_t *mStringList;
  92. #endif
  93. };
  94. extern LL_COMMON_API LLStringTable gStringTable;
  95. //============================================================================
  96. // This class is designed to be used locally,
  97. // e.g. as a member of an LLXmlTree
  98. // Strings can be inserted only, then quickly looked up
  99. typedef const std::string* LLStdStringHandle;
  100. class LL_COMMON_API LLStdStringTable
  101. {
  102. public:
  103. LLStdStringTable(S32 tablesize = 0)
  104. {
  105. if (tablesize == 0)
  106. {
  107. tablesize = 256; // default
  108. }
  109. // Make sure tablesize is power of 2
  110. for (S32 i = 31; i>0; i--)
  111. {
  112. if (tablesize & (1<<i))
  113. {
  114. if (tablesize >= (3<<(i-1)))
  115. tablesize = (1<<(i+1));
  116. else
  117. tablesize = (1<<i);
  118. break;
  119. }
  120. }
  121. mTableSize = tablesize;
  122. mStringList = new string_set_t[tablesize];
  123. }
  124. ~LLStdStringTable()
  125. {
  126. cleanup();
  127. delete[] mStringList;
  128. }
  129. void cleanup()
  130. {
  131. // remove strings
  132. for (S32 i = 0; i<mTableSize; i++)
  133. {
  134. string_set_t& stringset = mStringList[i];
  135. for (string_set_t::iterator iter = stringset.begin(); iter != stringset.end(); iter++)
  136. {
  137. delete *iter;
  138. }
  139. stringset.clear();
  140. }
  141. }
  142. LLStdStringHandle lookup(const std::string& s)
  143. {
  144. U32 hashval = makehash(s);
  145. return lookup(hashval, s);
  146. }
  147. LLStdStringHandle checkString(const std::string& s)
  148. {
  149. U32 hashval = makehash(s);
  150. return lookup(hashval, s);
  151. }
  152. LLStdStringHandle insert(const std::string& s)
  153. {
  154. U32 hashval = makehash(s);
  155. LLStdStringHandle result = lookup(hashval, s);
  156. if (result == NULL)
  157. {
  158. result = new std::string(s);
  159. mStringList[hashval].insert(result);
  160. }
  161. return result;
  162. }
  163. LLStdStringHandle addString(const std::string& s)
  164. {
  165. return insert(s);
  166. }
  167. private:
  168. U32 makehash(const std::string& s)
  169. {
  170. S32 len = (S32)s.size();
  171. const char* c = s.c_str();
  172. U32 hashval = 0;
  173. for (S32 i=0; i<len; i++)
  174. {
  175. hashval = ((hashval<<5) + hashval) + *c++;
  176. }
  177. return hashval & (mTableSize-1);
  178. }
  179. LLStdStringHandle lookup(U32 hashval, const std::string& s)
  180. {
  181. string_set_t& stringset = mStringList[hashval];
  182. LLStdStringHandle handle = &s;
  183. string_set_t::iterator iter = stringset.find(handle); // compares actual strings
  184. if (iter != stringset.end())
  185. {
  186. return *iter;
  187. }
  188. else
  189. {
  190. return NULL;
  191. }
  192. }
  193. private:
  194. S32 mTableSize;
  195. typedef std::set<LLStdStringHandle, compare_pointer_contents<std::string> > string_set_t;
  196. string_set_t* mStringList; // [mTableSize]
  197. };
  198. #endif