<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.3.1"/>
<title>xrootd: XrdOucHash.hh Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">xrootd
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.3.1 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>File Members</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_68267d1309a1af8e8297ef4c3efbcdba.html">src</a></li><li class="navelem"><a class="el" href="dir_a84cd9d3995a3fdd61364d705353c9e4.html">XrdOuc</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">XrdOucHash.hh</div> </div>
</div><!--header-->
<div class="contents">
<a href="XrdOucHash_8hh.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="preprocessor">#ifndef __OOUC_HASH__</span></div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="preprocessor"></span><span class="preprocessor">#define __OOUC_HASH__</span></div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="preprocessor"></span><span class="comment">/******************************************************************************/</span></div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment">/* */</span></div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment">/* X r d O u c H a s h . h h */</span></div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment">/* */</span></div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment">/* (c) 2004 by the Board of Trustees of the Leland Stanford, Jr., University */</span></div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment">/* Produced by Andrew Hanushevsky for Stanford University under contract */</span></div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment">/* DE-AC02-76-SFO0515 with the Department of Energy */</span></div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">/* */</span></div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment">/* This file is part of the XRootD software suite. */</span></div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment">/* */</span></div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment">/* XRootD is free software: you can redistribute it and/or modify it under */</span></div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment">/* the terms of the GNU Lesser General Public License as published by the */</span></div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment">/* Free Software Foundation, either version 3 of the License, or (at your */</span></div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment">/* option) any later version. */</span></div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment">/* */</span></div>
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment">/* XRootD is distributed in the hope that it will be useful, but WITHOUT */</span></div>
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment">/* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or */</span></div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment">/* FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public */</span></div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment">/* License for more details. */</span></div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment">/* */</span></div>
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment">/* You should have received a copy of the GNU Lesser General Public License */</span></div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment">/* along with XRootD in a file called COPYING.LESSER (LGPL license) and file */</span></div>
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="comment">/* COPYING (GPL license). If not, see <http://www.gnu.org/licenses/>. */</span></div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="comment">/* */</span></div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="comment">/* The copyright holder's institutional names and contributor's names may not */</span></div>
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="comment">/* be used to endorse or promote products derived from this software without */</span></div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="comment">/* specific prior written permission of the institution or contributor. */</span></div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="comment">/******************************************************************************/</span></div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> </div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <stdlib.h></span></div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <sys/types.h></span></div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#include <string.h></span></div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">#include <time.h></span></div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> </div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="comment">/*</span></div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="comment">Hash_data_is_key - The key and data are the same so when an item is added</span></div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="comment"> the data pointer is set to the key address.</span></div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="comment">Hash_replace - When adding an item, any existing item is replaced.</span></div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment">Hash_count - The number of deletion requests must equal the number of</span></div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment"> additions before the item is actually deleted.</span></div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment">Hash_keep - When the item is added, the key is not duplicated and</span></div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment"> when the item is deleted, the key *and* data are not deleted.</span></div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">Hash_dofree - When an item is deleted the data is released using free()</span></div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment"> instead of delete().</span></div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">Hash_keepdata - Works like Hash_keep but only applies to the data object.</span></div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment"> When adding the entry, the key is strdup'd and when deleting</span></div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment"> an entry, the key is freed.</span></div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">*/</span></div>
<div class="line"><a name="l00051"></a><span class="lineno"><a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971"> 51</a></span> <span class="keyword">enum</span> <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971">XrdOucHash_Options</a> {<a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a4a76eb8a22612959580a1aaddfcbe160">Hash_default</a> = 0x0000,</div>
<div class="line"><a name="l00052"></a><span class="lineno"><a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a286ca980ba563ad16421aa55f8ebe993"> 52</a></span>  <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a286ca980ba563ad16421aa55f8ebe993">Hash_data_is_key</a> = 0x0001,</div>
<div class="line"><a name="l00053"></a><span class="lineno"><a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a4f73ab1cbf63e75478754272686ae84f"> 53</a></span>  <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a4f73ab1cbf63e75478754272686ae84f">Hash_replace</a> = 0x0002,</div>
<div class="line"><a name="l00054"></a><span class="lineno"><a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a043d7f8c43594b156ba8c595c44d560d"> 54</a></span>  <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a043d7f8c43594b156ba8c595c44d560d">Hash_count</a> = 0x0004,</div>
<div class="line"><a name="l00055"></a><span class="lineno"><a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a6748fa9083e9ed85dafaf06f0e08788c"> 55</a></span>  <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a6748fa9083e9ed85dafaf06f0e08788c">Hash_keep</a> = 0x0008,</div>
<div class="line"><a name="l00056"></a><span class="lineno"><a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971aacafc7a9a1f33efdcb77a06cf44c0b85"> 56</a></span>  <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971aacafc7a9a1f33efdcb77a06cf44c0b85">Hash_dofree</a> = 0x0010,</div>
<div class="line"><a name="l00057"></a><span class="lineno"><a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a2dbc362a1b1a937ce69d8c5b31560d4a"> 57</a></span>  <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a2dbc362a1b1a937ce69d8c5b31560d4a">Hash_keepdata</a> = 0x0020</div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  };</div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  </div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="keyword">template</span><<span class="keyword">class</span> T></div>
<div class="line"><a name="l00061"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html"> 61</a></span> <span class="keyword">class </span><a class="code" href="classXrdOucHash__Item.html">XrdOucHash_Item</a></div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span> {</div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="keyword">public</span>:</div>
<div class="line"><a name="l00064"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a747e3c5eacfdd5bfc4ae4654f9515198"> 64</a></span> <span class="keywordtype">int</span> <a class="code" href="classXrdOucHash__Item.html#a747e3c5eacfdd5bfc4ae4654f9515198">Count</a>() {<span class="keywordflow">return</span> <a class="code" href="classXrdOucHash__Item.html#ae549f0aa52d2f68a9713e72812c31b6b">keycount</a>;}</div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> </div>
<div class="line"><a name="l00066"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a27de092736b6a564b371e8d3b2d9e00a"> 66</a></span> T *<a class="code" href="classXrdOucHash__Item.html#a27de092736b6a564b371e8d3b2d9e00a">Data</a>() {<span class="keywordflow">return</span> <a class="code" href="classXrdOucHash__Item.html#a8a15042ee10616f3b4810bf7d10648a0">keydata</a>;}</div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span> </div>
<div class="line"><a name="l00068"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a0f4fbe564e7a7ab568f07302226ef0aa"> 68</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <a class="code" href="classXrdOucHash__Item.html#a0f4fbe564e7a7ab568f07302226ef0aa">Hash</a>() {<span class="keywordflow">return</span> <a class="code" href="classXrdOucHash__Item.html#ae73afb212f1ed6dc46eb6cecdcb7353c">keyhash</a>;}</div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span> </div>
<div class="line"><a name="l00070"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a95d55e9cd8d9976ca3482e2fef28689e"> 70</a></span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="classXrdOucHash__Item.html#a95d55e9cd8d9976ca3482e2fef28689e">Key</a>() {<span class="keywordflow">return</span> <a class="code" href="classXrdOucHash__Item.html#af1b799725e00b80e29d13a5881ad79ac">keyval</a>;}</div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span> </div>
<div class="line"><a name="l00072"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a7c4c43e323af66902f81bd88e72603e2"> 72</a></span> <a class="code" href="classXrdOucHash__Item.html">XrdOucHash_Item<T></a> *<a class="code" href="classXrdOucHash__Item.html#a7c4c43e323af66902f81bd88e72603e2">Next</a>() {<span class="keywordflow">return</span> <a class="code" href="classXrdOucHash__Item.html#ab185f2bca82473f26cd6e149037133a5">next</a>;}</div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> </div>
<div class="line"><a name="l00074"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a709ff72ab82fe896383228824499b376"> 74</a></span> time_t <a class="code" href="classXrdOucHash__Item.html#a709ff72ab82fe896383228824499b376">Time</a>() {<span class="keywordflow">return</span> <a class="code" href="classXrdOucHash__Item.html#abf4e7cf9164a4e312bd15d961e0e8458">keytime</a>;}</div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span> </div>
<div class="line"><a name="l00076"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a6aa32af70ecaacc16fca8fc717afa1d7"> 76</a></span> <span class="keywordtype">void</span> <a class="code" href="classXrdOucHash__Item.html#a6aa32af70ecaacc16fca8fc717afa1d7">Update</a>(<span class="keywordtype">int</span> newcount, time_t newtime)</div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  {<a class="code" href="classXrdOucHash__Item.html#ae549f0aa52d2f68a9713e72812c31b6b">keycount</a> = newcount; </div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  <span class="keywordflow">if</span> (newtime) <a class="code" href="classXrdOucHash__Item.html#abf4e7cf9164a4e312bd15d961e0e8458">keytime</a> = newtime;</div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  }</div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span> </div>
<div class="line"><a name="l00081"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a22c6731d3b1128cccee1b0698a1f0bc0"> 81</a></span> <span class="keywordtype">int</span> <a class="code" href="classXrdOucHash__Item.html#a22c6731d3b1128cccee1b0698a1f0bc0">Same</a>(<span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> KeyHash, <span class="keyword">const</span> <span class="keywordtype">char</span> *KeyVal)</div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  {<span class="keywordflow">return</span> <a class="code" href="classXrdOucHash__Item.html#ae73afb212f1ed6dc46eb6cecdcb7353c">keyhash</a> == KeyHash && !strcmp(<a class="code" href="classXrdOucHash__Item.html#af1b799725e00b80e29d13a5881ad79ac">keyval</a>, KeyVal);}</div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span> </div>
<div class="line"><a name="l00084"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#ae920bfbe5c93df407deea814224ceb9f"> 84</a></span> <span class="keywordtype">void</span> <a class="code" href="classXrdOucHash__Item.html#ae920bfbe5c93df407deea814224ceb9f">SetNext</a>(<a class="code" href="classXrdOucHash__Item.html">XrdOucHash_Item<T></a> *item) {<a class="code" href="classXrdOucHash__Item.html#ab185f2bca82473f26cd6e149037133a5">next</a> = item;}</div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span> </div>
<div class="line"><a name="l00086"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a1869c3dd863729d2c6ead28a74c699a4"> 86</a></span>  <a class="code" href="classXrdOucHash__Item.html#a1869c3dd863729d2c6ead28a74c699a4">XrdOucHash_Item</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> KeyHash,</div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  <span class="keyword">const</span> <span class="keywordtype">char</span> *KeyVal,</div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  T *KeyData,</div>
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  time_t KeyTime,</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  <a class="code" href="classXrdOucHash__Item.html">XrdOucHash_Item<T></a> *KeyNext,</div>
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971">XrdOucHash_Options</a> KeyOpts)</div>
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  {<a class="code" href="classXrdOucHash__Item.html#ae73afb212f1ed6dc46eb6cecdcb7353c">keyhash</a> = KeyHash; </div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  <span class="keywordflow">if</span> (KeyOpts & <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a6748fa9083e9ed85dafaf06f0e08788c">Hash_keep</a>) <a class="code" href="classXrdOucHash__Item.html#af1b799725e00b80e29d13a5881ad79ac">keyval</a> = KeyVal;</div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  <span class="keywordflow">else</span> <a class="code" href="classXrdOucHash__Item.html#af1b799725e00b80e29d13a5881ad79ac">keyval</a> = strdup(KeyVal);</div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="keywordflow">if</span> (KeyOpts & <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a286ca980ba563ad16421aa55f8ebe993">Hash_data_is_key</a>) <a class="code" href="classXrdOucHash__Item.html#a8a15042ee10616f3b4810bf7d10648a0">keydata</a> = (T *)<a class="code" href="classXrdOucHash__Item.html#af1b799725e00b80e29d13a5881ad79ac">keyval</a>;</div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  <span class="keywordflow">else</span> <a class="code" href="classXrdOucHash__Item.html#a8a15042ee10616f3b4810bf7d10648a0">keydata</a> = KeyData;</div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  <a class="code" href="classXrdOucHash__Item.html#abf4e7cf9164a4e312bd15d961e0e8458">keytime</a> = KeyTime;</div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  <a class="code" href="classXrdOucHash__Item.html#a48cd578390ebc826cbac8ffb9bcb7f3a">entopts</a> = KeyOpts;</div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <a class="code" href="classXrdOucHash__Item.html#ab185f2bca82473f26cd6e149037133a5">next</a> = KeyNext;</div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <a class="code" href="classXrdOucHash__Item.html#ae549f0aa52d2f68a9713e72812c31b6b">keycount</a>= 0;</div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  }</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span> </div>
<div class="line"><a name="l00103"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a4a38a58803a41f18b24a35164954d085"> 103</a></span>  <a class="code" href="classXrdOucHash__Item.html#a4a38a58803a41f18b24a35164954d085">~XrdOucHash_Item</a>()</div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  {<span class="keywordflow">if</span> (!(<a class="code" href="classXrdOucHash__Item.html#a48cd578390ebc826cbac8ffb9bcb7f3a">entopts</a> & <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a6748fa9083e9ed85dafaf06f0e08788c">Hash_keep</a>))</div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  {<span class="keywordflow">if</span> (<a class="code" href="classXrdOucHash__Item.html#a8a15042ee10616f3b4810bf7d10648a0">keydata</a> && <a class="code" href="classXrdOucHash__Item.html#a8a15042ee10616f3b4810bf7d10648a0">keydata</a> != (T *)<a class="code" href="classXrdOucHash__Item.html#af1b799725e00b80e29d13a5881ad79ac">keyval</a> </div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  && !(<a class="code" href="classXrdOucHash__Item.html#a48cd578390ebc826cbac8ffb9bcb7f3a">entopts</a> & <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a2dbc362a1b1a937ce69d8c5b31560d4a">Hash_keepdata</a>))</div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  {<span class="keywordflow">if</span> (<a class="code" href="classXrdOucHash__Item.html#a48cd578390ebc826cbac8ffb9bcb7f3a">entopts</a> & <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971aacafc7a9a1f33efdcb77a06cf44c0b85">Hash_dofree</a>) free(<a class="code" href="classXrdOucHash__Item.html#a8a15042ee10616f3b4810bf7d10648a0">keydata</a>);</div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="keywordflow">else</span> <span class="keyword">delete</span> <a class="code" href="classXrdOucHash__Item.html#a8a15042ee10616f3b4810bf7d10648a0">keydata</a>;</div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  }</div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  <span class="keywordflow">if</span> (<a class="code" href="classXrdOucHash__Item.html#af1b799725e00b80e29d13a5881ad79ac">keyval</a>) free((<span class="keywordtype">void</span> *)<a class="code" href="classXrdOucHash__Item.html#af1b799725e00b80e29d13a5881ad79ac">keyval</a>);</div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  }</div>
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  <a class="code" href="classXrdOucHash__Item.html#a8a15042ee10616f3b4810bf7d10648a0">keydata</a> = 0; <a class="code" href="classXrdOucHash__Item.html#af1b799725e00b80e29d13a5881ad79ac">keyval</a> = 0; <a class="code" href="classXrdOucHash__Item.html#ae549f0aa52d2f68a9713e72812c31b6b">keycount</a> = 0;</div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span>  }</div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span> </div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="keyword">private</span>:</div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span> </div>
<div class="line"><a name="l00117"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#ab185f2bca82473f26cd6e149037133a5"> 117</a></span> <a class="code" href="classXrdOucHash__Item.html">XrdOucHash_Item<T></a> *<a class="code" href="classXrdOucHash__Item.html#ab185f2bca82473f26cd6e149037133a5">next</a>;</div>
<div class="line"><a name="l00118"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#af1b799725e00b80e29d13a5881ad79ac"> 118</a></span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="classXrdOucHash__Item.html#af1b799725e00b80e29d13a5881ad79ac">keyval</a>;</div>
<div class="line"><a name="l00119"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#ae73afb212f1ed6dc46eb6cecdcb7353c"> 119</a></span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <a class="code" href="classXrdOucHash__Item.html#ae73afb212f1ed6dc46eb6cecdcb7353c">keyhash</a>;</div>
<div class="line"><a name="l00120"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a8a15042ee10616f3b4810bf7d10648a0"> 120</a></span> T *<a class="code" href="classXrdOucHash__Item.html#a8a15042ee10616f3b4810bf7d10648a0">keydata</a>;</div>
<div class="line"><a name="l00121"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#abf4e7cf9164a4e312bd15d961e0e8458"> 121</a></span> time_t <a class="code" href="classXrdOucHash__Item.html#abf4e7cf9164a4e312bd15d961e0e8458">keytime</a>;</div>
<div class="line"><a name="l00122"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#ae549f0aa52d2f68a9713e72812c31b6b"> 122</a></span> <span class="keywordtype">int</span> <a class="code" href="classXrdOucHash__Item.html#ae549f0aa52d2f68a9713e72812c31b6b">keycount</a>;</div>
<div class="line"><a name="l00123"></a><span class="lineno"><a class="code" href="classXrdOucHash__Item.html#a48cd578390ebc826cbac8ffb9bcb7f3a"> 123</a></span> <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971">XrdOucHash_Options</a> <a class="code" href="classXrdOucHash__Item.html#a48cd578390ebc826cbac8ffb9bcb7f3a">entopts</a>;</div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span> };</div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span> </div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="keyword">template</span><<span class="keyword">class</span> T></div>
<div class="line"><a name="l00127"></a><span class="lineno"><a class="code" href="classXrdOucHash.html"> 127</a></span> <span class="keyword">class </span><a class="code" href="classXrdOucHash.html">XrdOucHash</a></div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span> {</div>
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span> <span class="keyword">public</span>:</div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span> </div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span> <span class="comment">// Add() adds a new item to the hash. If it exists and repl = 0 then the old</span></div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span> <span class="comment">// entry is returned and the new data is not added. Otherwise the current</span></div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span> <span class="comment">// entry is replaced (see Rep()) and 0 is returned. If we have no memory</span></div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span> <span class="comment">// to add the new entry, an ENOMEM exception is thrown. The</span></div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span> <span class="comment">// LifeTime value is the number of seconds this entry is to be considered</span></div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> <span class="comment">// valid. When the time has passed, the entry may be deleted. A value</span></div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span> <span class="comment">// of zero, keeps the entry until explicitly deleted. A special feature</span></div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span> <span class="comment">// allows the data to be associated with the key to be the actual key</span></div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span> <span class="comment">// using the Hash_data_is_key option. In this case, KeyData is ignored.</span></div>
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span> <span class="comment">// The Hash_count option keeps track of duplicate key entries for Del.</span></div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span> <span class="comment">//</span></div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span> T *<a class="code" href="classXrdOucHash.html#afab1e5be93d36080a50457b2f7a6b98c">Add</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *KeyVal, T *KeyData, <span class="keyword">const</span> <span class="keywordtype">int</span> LifeTime=0, </div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971">XrdOucHash_Options</a> opt=<a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a4a76eb8a22612959580a1aaddfcbe160">Hash_default</a>);</div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span> </div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span> <span class="comment">// Del() deletes the item from the hash. If it doesn't exist, it returns</span></div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span> <span class="comment">// -ENOENT. Otherwise 0 is returned. If the Hash_count option is specified</span></div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span> <span class="comment">// tyhen the entry is only deleted when the entry count is below 0.</span></div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span> <span class="comment">//</span></div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span> <span class="keywordtype">int</span> <a class="code" href="classXrdOucHash.html#a06d160dfbba660edafd1f47f8f229f3f">Del</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *KeyVal, <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971">XrdOucHash_Options</a> opt = <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a4a76eb8a22612959580a1aaddfcbe160">Hash_default</a>);</div>
<div class="line"><a name="l00150"></a><span class="lineno"> 150</span> </div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span> <span class="comment">// Find() simply looks up an entry in the cache. It can optionally return the</span></div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span> <span class="comment">// lifetime associated with the entry. If the</span></div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span> <span class="comment">//</span></div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span> T *<a class="code" href="classXrdOucHash.html#ad1474ba6dbfc3026233135e9229c1006">Find</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *KeyVal, time_t *KeyTime=0);</div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span> </div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span> <span class="comment">// Num() returns the number of items in the hash table</span></div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span> <span class="comment">//</span></div>
<div class="line"><a name="l00158"></a><span class="lineno"><a class="code" href="classXrdOucHash.html#acf28b4be599993ebee503315f22b3b6e"> 158</a></span> <span class="keywordtype">int</span> <a class="code" href="classXrdOucHash.html#acf28b4be599993ebee503315f22b3b6e">Num</a>() {<span class="keywordflow">return</span> <a class="code" href="classXrdOucHash.html#ac0a9aafbbc54730320cf18c43ae92a52">hashnum</a>;}</div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span> </div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span> <span class="comment">// Purge() simply deletes all of the appendages to the table.</span></div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span> <span class="comment">//</span></div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span> <span class="keywordtype">void</span> <a class="code" href="classXrdOucHash.html#a08b3c0d5a9091d1814134b035ac474ee">Purge</a>();</div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span> </div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span> <span class="comment">// Rep() is simply Add() that allows replacement.</span></div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span> <span class="comment">//</span></div>
<div class="line"><a name="l00166"></a><span class="lineno"><a class="code" href="classXrdOucHash.html#a474659a4b3cee73c7a6f69a68e90ea19"> 166</a></span> T *<a class="code" href="classXrdOucHash.html#a474659a4b3cee73c7a6f69a68e90ea19">Rep</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *KeyVal, T *KeyData, <span class="keyword">const</span> <span class="keywordtype">int</span> LifeTime=0,</div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971">XrdOucHash_Options</a> opt=<a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a4a76eb8a22612959580a1aaddfcbe160">Hash_default</a>)</div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  {<span class="keywordflow">return</span> <a class="code" href="classXrdOucHash.html#afab1e5be93d36080a50457b2f7a6b98c">Add</a>(KeyVal, KeyData, LifeTime, </div>
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  (<a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971">XrdOucHash_Options</a>)(opt | <a class="code" href="XrdOucHash_8hh.html#abdfc9a691e5275211ba4ececef6c0971a4f73ab1cbf63e75478754272686ae84f">Hash_replace</a>));}</div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span> </div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span> <span class="comment">// Apply() applies the specified function to every item in the hash. The</span></div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span> <span class="comment">// first argument is the key value, the second is the associated data,</span></div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span> <span class="comment">// the third argument is whatever is the passed in void *variable, The</span></div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span> <span class="comment">// following actions occur for values returned by the applied function:</span></div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span> <span class="comment">// <0 - The hash table item is deleted.</span></div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span> <span class="comment">// =0 - The next hash table item is processed.</span></div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span> <span class="comment">// >0 - Processing stops and the hash table item is returned.</span></div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span> <span class="comment">//</span></div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span> T *<a class="code" href="classXrdOucHash.html#a1308eb0669a9e1a2983a0b642bb70ab7">Apply</a>(<span class="keywordtype">int</span> (*func)(<span class="keyword">const</span> <span class="keywordtype">char</span> *, T *, <span class="keywordtype">void</span> *), <span class="keywordtype">void</span> *Arg);</div>
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span> </div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span> <span class="comment">// When allocateing a new hash, specify the required starting size. Make</span></div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span> <span class="comment">// sure that the previous number is the correct Fibonocci antecedent. The</span></div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span> <span class="comment">// series is simply n[j] = n[j-1] + n[j-2].</span></div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span> <span class="comment">//</span></div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  <a class="code" href="classXrdOucHash.html#af5fe785fdf15dfba5e1ed9e4b3487eae">XrdOucHash</a>(<span class="keywordtype">int</span> psize = 89, <span class="keywordtype">int</span> size=144, <span class="keywordtype">int</span> load=80);</div>
<div class="line"><a name="l00186"></a><span class="lineno"><a class="code" href="classXrdOucHash.html#a12a9d187734f5766954802589a431bb3"> 186</a></span>  <a class="code" href="classXrdOucHash.html#a12a9d187734f5766954802589a431bb3">~XrdOucHash</a>() {<span class="keywordflow">if</span> (<a class="code" href="classXrdOucHash.html#afe78b837376704ae72ddcdc9be9f453f">hashtable</a>) {<a class="code" href="classXrdOucHash.html#a08b3c0d5a9091d1814134b035ac474ee">Purge</a>(); free(<a class="code" href="classXrdOucHash.html#afe78b837376704ae72ddcdc9be9f453f">hashtable</a>); <a class="code" href="classXrdOucHash.html#afe78b837376704ae72ddcdc9be9f453f">hashtable</a> = 0;}}</div>
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span> </div>
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span> <span class="keyword">private</span>:</div>
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span> <span class="keywordtype">void</span> <a class="code" href="classXrdOucHash.html#a86a8c300af1dc85986f58ddca2bbae57">Remove</a>(<span class="keywordtype">int</span> kent, <a class="code" href="classXrdOucHash__Item.html">XrdOucHash_Item<T></a> *hip, <a class="code" href="classXrdOucHash__Item.html">XrdOucHash_Item<T></a> *phip);</div>
<div class="line"><a name="l00190"></a><span class="lineno"> 190</span> </div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span> <a class="code" href="classXrdOucHash__Item.html">XrdOucHash_Item<T></a> *<a class="code" href="classXrdOucHash.html#a021e2ad215687563f695a57475ae93ff">Search</a>(<a class="code" href="classXrdOucHash__Item.html">XrdOucHash_Item<T></a> *hip, </div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> khash,</div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span>  <span class="keyword">const</span> <span class="keywordtype">char</span> *kval, </div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <a class="code" href="classXrdOucHash__Item.html">XrdOucHash_Item<T></a> **phip=0);</div>
<div class="line"><a name="l00195"></a><span class="lineno"> 195</span> </div>
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> <a class="code" href="classXrdOucHash.html#a1f0e845305def8bced1e41e8e5615b5b">HashVal</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *KeyVal);</div>
<div class="line"><a name="l00197"></a><span class="lineno"> 197</span> </div>
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span> <span class="keywordtype">void</span> <a class="code" href="classXrdOucHash.html#a5a4c8b165ff8071cda11a51de2a270b3">Expand</a>();</div>
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span> </div>
<div class="line"><a name="l00200"></a><span class="lineno"><a class="code" href="classXrdOucHash.html#afe78b837376704ae72ddcdc9be9f453f"> 200</a></span> <a class="code" href="classXrdOucHash__Item.html">XrdOucHash_Item<T></a> **<a class="code" href="classXrdOucHash.html#afe78b837376704ae72ddcdc9be9f453f">hashtable</a>;</div>
<div class="line"><a name="l00201"></a><span class="lineno"><a class="code" href="classXrdOucHash.html#ac978308ac47bd8006f0e9c265f87ebba"> 201</a></span> <span class="keywordtype">int</span> <a class="code" href="classXrdOucHash.html#ac978308ac47bd8006f0e9c265f87ebba">prevtablesize</a>;</div>
<div class="line"><a name="l00202"></a><span class="lineno"><a class="code" href="classXrdOucHash.html#a3ddabf98a72629164e609ba433b6a1fe"> 202</a></span> <span class="keywordtype">int</span> <a class="code" href="classXrdOucHash.html#a3ddabf98a72629164e609ba433b6a1fe">hashtablesize</a>;</div>
<div class="line"><a name="l00203"></a><span class="lineno"><a class="code" href="classXrdOucHash.html#ac0a9aafbbc54730320cf18c43ae92a52"> 203</a></span> <span class="keywordtype">int</span> <a class="code" href="classXrdOucHash.html#ac0a9aafbbc54730320cf18c43ae92a52">hashnum</a>;</div>
<div class="line"><a name="l00204"></a><span class="lineno"><a class="code" href="classXrdOucHash.html#afc5776179a56429f0d52c50677accc20"> 204</a></span> <span class="keywordtype">int</span> <a class="code" href="classXrdOucHash.html#afc5776179a56429f0d52c50677accc20">hashmax</a>;</div>
<div class="line"><a name="l00205"></a><span class="lineno"><a class="code" href="classXrdOucHash.html#a9ac0fab41f8f0fa5f4c2565667c1d7bc"> 205</a></span> <span class="keywordtype">int</span> <a class="code" href="classXrdOucHash.html#a9ac0fab41f8f0fa5f4c2565667c1d7bc">hashload</a>;</div>
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span> };</div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span> </div>
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span> <span class="comment">/******************************************************************************/</span></div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span> <span class="comment">/* A c t u a l I m p l e m e n t a t i o n */</span></div>
<div class="line"><a name="l00210"></a><span class="lineno"> 210</span> <span class="comment">/******************************************************************************/</span></div>
<div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  </div>
<div class="line"><a name="l00212"></a><span class="lineno"> 212</span> <span class="preprocessor">#include "XrdOuc/XrdOucHash.icc"</span></div>
<div class="line"><a name="l00213"></a><span class="lineno"> 213</span> <span class="preprocessor">#endif</span></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.3.1
</small></address>
</body>
</html>
distrib
>
Fedora
>
18
>
x86_64
>
media
>
updates
>
by-pkgid
>
749e483016bbc41594aeb77eb13e3491
>
files
>
316
