<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>Apache Portable Runtime: Hash Tables</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.4.7 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul></div>
<h1>Hash Tables<br>
<small>
[<a class="el" href="group___a_p_r.html">Apache Portability Runtime library</a>]</small>
</h1><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#gf57b6660109b256051b826d11426bfd2">APR_HASH_KEY_STRING</a> (-1)</td></tr>
<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef unsigned int(*) </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#gde9571fe169b5aab768755f9ca434118">apr_hashfunc_t</a> (const char *key, apr_ssize_t *klen)</td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#gb610fd182aa2f60a282954f6bc3ecda1">apr_hashfunc_default</a> (const char *key, apr_ssize_t *klen)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#gd68c9af37233cc33abdb563830b44f58">apr_hash_make</a> (<a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> *pool)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#g5293c8aa6fa93bd045f5832ac8907440">apr_hash_make_custom</a> (<a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> *pool, <a class="el" href="group__apr__hash.html#gde9571fe169b5aab768755f9ca434118">apr_hashfunc_t</a> hash_func)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#g3057f4753fcb0d2a78e4a814c41b919e">apr_hash_copy</a> (<a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> *pool, const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> *h)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#g530afd149916e2335a92b2c5f471cd5d">apr_hash_set</a> (<a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> *ht, const void *key, apr_ssize_t klen, const void *val)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#g27c63ed475f8d6a40a85b5a463d755ec">apr_hash_get</a> (<a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> *ht, const void *key, apr_ssize_t klen)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#g9aade33672785484ce6a5e69e0416895">apr_hash_first</a> (<a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> *p, <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> *ht)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#g4979bfc313d4b5eb3f4ea99953d56269">apr_hash_next</a> (<a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a> *hi)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#g5764caa0b3e4f3557747732517093439">apr_hash_this</a> (<a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a> *hi, const void **key, apr_ssize_t *klen, void **val)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#g969cec2569ae8405246e65413e6a77eb">apr_hash_count</a> (<a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> *ht)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#gedeafcf4bc8a71560d4bd861a84166fd">apr_hash_overlay</a> (<a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> *p, const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> *overlay, const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> *base)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#g2699d80e0af3b6cbb617aa2cc8358d22">apr_hash_merge</a> (<a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> *p, const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> *h1, const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> *h2, void *(*merger)(<a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> *p, const void *key, apr_ssize_t klen, const void *h1_val, const void *h2_val, const void *data), const void *data)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#g3475516ca1288409f9c133b78ad73cb4">apr_hash_pool_get</a> (const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> *thehash)</td></tr>
</table>
<hr><h2>Define Documentation</h2>
<a class="anchor" name="gf57b6660109b256051b826d11426bfd2"></a><!-- doxytag: member="apr_hash.h::APR_HASH_KEY_STRING" ref="gf57b6660109b256051b826d11426bfd2" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_HASH_KEY_STRING (-1) </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
When passing a key to apr_hash_set or apr_hash_get, this value can be passed to indicate a string-valued key, and have apr_hash compute the length automatically.<p>
<dl compact><dt><b>Remarks:</b></dt><dd>apr_hash will use strlen(key) for the length. The NUL terminator is not included in the hash value (why throw a constant in?). Since the hash table merely references the provided key (rather than copying it), <a class="el" href="group__apr__hash.html#g5764caa0b3e4f3557747732517093439">apr_hash_this()</a> will return the NUL-term'd key. </dd></dl>
</div>
</div><p>
<hr><h2>Typedef Documentation</h2>
<a class="anchor" name="gc6e26dffc898c9409010578ee8090943"></a><!-- doxytag: member="apr_hash.h::apr_hash_index_t" ref="gc6e26dffc898c9409010578ee8090943" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a> <a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Abstract type for scanning hash tables.
</div>
</div><p>
<a class="anchor" name="gdd5042ee41cc849b70b77d44b66dffc4"></a><!-- doxytag: member="apr_hash.h::apr_hash_t" ref="gdd5042ee41cc849b70b77d44b66dffc4" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Abstract type for hash tables.
</div>
</div><p>
<a class="anchor" name="gde9571fe169b5aab768755f9ca434118"></a><!-- doxytag: member="apr_hash.h::apr_hashfunc_t" ref="gde9571fe169b5aab768755f9ca434118" args="(const char *key, apr_ssize_t *klen)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef unsigned int(*) <a class="el" href="group__apr__hash.html#gde9571fe169b5aab768755f9ca434118">apr_hashfunc_t</a>(const char *key, apr_ssize_t *klen) </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Callback functions for calculating hash values. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>The key. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>klen</em> </td><td>The length of the key, or APR_HASH_KEY_STRING to use the string length. If APR_HASH_KEY_STRING then returns the actual key length. </td></tr>
</table>
</dl>
</div>
</div><p>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="g3057f4753fcb0d2a78e4a814c41b919e"></a><!-- doxytag: member="apr_hash.h::apr_hash_copy" ref="g3057f4753fcb0d2a78e4a814c41b919e" args="(apr_pool_t *pool, const apr_hash_t *h)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a>* apr_hash_copy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td>
<td class="paramname"> <em>h</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Make a copy of a hash table <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>The pool from which to allocate the new hash table </td></tr>
<tr><td valign="top"></td><td valign="top"><em>h</em> </td><td>The hash table to clone </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The hash table just created </dd></dl>
<dl compact><dt><b>Remarks:</b></dt><dd>Makes a shallow copy </dd></dl>
</div>
</div><p>
<a class="anchor" name="g969cec2569ae8405246e65413e6a77eb"></a><!-- doxytag: member="apr_hash.h::apr_hash_count" ref="g969cec2569ae8405246e65413e6a77eb" args="(apr_hash_t *ht)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">unsigned int apr_hash_count </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td>
<td class="paramname"> <em>ht</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the number of key/value pairs in the hash table. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>ht</em> </td><td>The hash table </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of key/value pairs in the hash table. </dd></dl>
</div>
</div><p>
<a class="anchor" name="g9aade33672785484ce6a5e69e0416895"></a><!-- doxytag: member="apr_hash.h::apr_hash_first" ref="g9aade33672785484ce6a5e69e0416895" args="(apr_pool_t *p, apr_hash_t *ht)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a>* apr_hash_first </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> * </td>
<td class="paramname"> <em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td>
<td class="paramname"> <em>ht</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<pre></pre><p>
<pre> int sum_values(apr_pool_t *p, apr_hash_t *ht)
{
apr_hash_index_t *hi;
void *val;
int sum = 0;
for (hi = apr_hash_first(p, ht); hi; hi = apr_hash_next(hi)) {
apr_hash_this(hi, NULL, NULL, &val);
sum += *(int *)val;
}
return sum;
}
</pre>
</div>
</div><p>
<a class="anchor" name="g27c63ed475f8d6a40a85b5a463d755ec"></a><!-- doxytag: member="apr_hash.h::apr_hash_get" ref="g27c63ed475f8d6a40a85b5a463d755ec" args="(apr_hash_t *ht, const void *key, apr_ssize_t klen)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* apr_hash_get </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td>
<td class="paramname"> <em>ht</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void * </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_ssize_t </td>
<td class="paramname"> <em>klen</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Look up the value associated with a key in a hash table. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>ht</em> </td><td>The hash table </td></tr>
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>Pointer to the key </td></tr>
<tr><td valign="top"></td><td valign="top"><em>klen</em> </td><td>Length of the key. Can be APR_HASH_KEY_STRING to use the string length. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>Returns NULL if the key is not present. </dd></dl>
</div>
</div><p>
<a class="anchor" name="gd68c9af37233cc33abdb563830b44f58"></a><!-- doxytag: member="apr_hash.h::apr_hash_make" ref="gd68c9af37233cc33abdb563830b44f58" args="(apr_pool_t *pool)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a>* apr_hash_make </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> * </td>
<td class="paramname"> <em>pool</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a hash table. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>The pool to allocate the hash table out of </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The hash table just created </dd></dl>
</div>
</div><p>
<a class="anchor" name="g5293c8aa6fa93bd045f5832ac8907440"></a><!-- doxytag: member="apr_hash.h::apr_hash_make_custom" ref="g5293c8aa6fa93bd045f5832ac8907440" args="(apr_pool_t *pool, apr_hashfunc_t hash_func)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a>* apr_hash_make_custom </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__apr__hash.html#gde9571fe169b5aab768755f9ca434118">apr_hashfunc_t</a> </td>
<td class="paramname"> <em>hash_func</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a hash table with a custom hash function <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>The pool to allocate the hash table out of </td></tr>
<tr><td valign="top"></td><td valign="top"><em>hash_func</em> </td><td>A custom hash function. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The hash table just created </dd></dl>
</div>
</div><p>
<a class="anchor" name="g2699d80e0af3b6cbb617aa2cc8358d22"></a><!-- doxytag: member="apr_hash.h::apr_hash_merge" ref="g2699d80e0af3b6cbb617aa2cc8358d22" args="(apr_pool_t *p, const apr_hash_t *h1, const apr_hash_t *h2, void *(*merger)(apr_pool_t *p, const void *key, apr_ssize_t klen, const void *h1_val, const void *h2_val, const void *data), const void *data)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a>* apr_hash_merge </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> * </td>
<td class="paramname"> <em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td>
<td class="paramname"> <em>h1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td>
<td class="paramname"> <em>h2</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void *(*)(<a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> *p, const void *key, apr_ssize_t klen, const void *h1_val, const void *h2_val, const void *data) </td>
<td class="paramname"> <em>merger</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void * </td>
<td class="paramname"> <em>data</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Merge two hash tables into one new hash table. If the same key is present in both tables, call the supplied merge function to produce a merged value for the key in the new table. Both hash tables must use the same hash function. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool to use for the new hash table </td></tr>
<tr><td valign="top"></td><td valign="top"><em>h1</em> </td><td>The first of the tables to merge </td></tr>
<tr><td valign="top"></td><td valign="top"><em>h2</em> </td><td>The second of the tables to merge </td></tr>
<tr><td valign="top"></td><td valign="top"><em>merger</em> </td><td>A callback function to merge values, or NULL to make values from h1 override values from h2 (same semantics as <a class="el" href="group__apr__hash.html#gedeafcf4bc8a71560d4bd861a84166fd">apr_hash_overlay()</a>) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>data</em> </td><td>Client data to pass to the merger function </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A new hash table containing all of the data from the two passed in </dd></dl>
</div>
</div><p>
<a class="anchor" name="g4979bfc313d4b5eb3f4ea99953d56269"></a><!-- doxytag: member="apr_hash.h::apr_hash_next" ref="g4979bfc313d4b5eb3f4ea99953d56269" args="(apr_hash_index_t *hi)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a>* apr_hash_next </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a> * </td>
<td class="paramname"> <em>hi</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Continue iterating over the entries in a hash table. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>hi</em> </td><td>The iteration state </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>a pointer to the updated iteration state. NULL if there are no more entries. </dd></dl>
</div>
</div><p>
<a class="anchor" name="gedeafcf4bc8a71560d4bd861a84166fd"></a><!-- doxytag: member="apr_hash.h::apr_hash_overlay" ref="gedeafcf4bc8a71560d4bd861a84166fd" args="(apr_pool_t *p, const apr_hash_t *overlay, const apr_hash_t *base)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a>* apr_hash_overlay </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a> * </td>
<td class="paramname"> <em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td>
<td class="paramname"> <em>overlay</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td>
<td class="paramname"> <em>base</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Merge two hash tables into one new hash table. The values of the overlay hash override the values of the base if both have the same key. Both hash tables must use the same hash function. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool to use for the new hash table </td></tr>
<tr><td valign="top"></td><td valign="top"><em>overlay</em> </td><td>The table to add to the initial table </td></tr>
<tr><td valign="top"></td><td valign="top"><em>base</em> </td><td>The table that represents the initial values of the new table </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A new hash table containing all of the data from the two passed in </dd></dl>
</div>
</div><p>
<a class="anchor" name="g3475516ca1288409f9c133b78ad73cb4"></a><!-- doxytag: member="apr_hash.h::apr_hash_pool_get" ref="g3475516ca1288409f9c133b78ad73cb4" args="(const apr_hash_t *thehash)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__pools.html#g06f17a7732f2d04d8ce7010fbb057a8b">apr_pool_t</a>* apr_hash_pool_get </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td>
<td class="paramname"> <em>thehash</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get a pointer to the pool which the hash table was created in
</div>
</div><p>
<a class="anchor" name="g530afd149916e2335a92b2c5f471cd5d"></a><!-- doxytag: member="apr_hash.h::apr_hash_set" ref="g530afd149916e2335a92b2c5f471cd5d" args="(apr_hash_t *ht, const void *key, apr_ssize_t klen, const void *val)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_hash_set </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__hash.html#gdd5042ee41cc849b70b77d44b66dffc4">apr_hash_t</a> * </td>
<td class="paramname"> <em>ht</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void * </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_ssize_t </td>
<td class="paramname"> <em>klen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void * </td>
<td class="paramname"> <em>val</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Associate a value with a key in a hash table. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>ht</em> </td><td>The hash table </td></tr>
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>Pointer to the key </td></tr>
<tr><td valign="top"></td><td valign="top"><em>klen</em> </td><td>Length of the key. Can be APR_HASH_KEY_STRING to use the string length. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>val</em> </td><td>Value to associate with the key </td></tr>
</table>
</dl>
<dl compact><dt><b>Remarks:</b></dt><dd>If the value is NULL the hash entry is deleted. </dd></dl>
</div>
</div><p>
<a class="anchor" name="g5764caa0b3e4f3557747732517093439"></a><!-- doxytag: member="apr_hash.h::apr_hash_this" ref="g5764caa0b3e4f3557747732517093439" args="(apr_hash_index_t *hi, const void **key, apr_ssize_t *klen, void **val)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_hash_this </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__hash.html#gc6e26dffc898c9409010578ee8090943">apr_hash_index_t</a> * </td>
<td class="paramname"> <em>hi</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const void ** </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_ssize_t * </td>
<td class="paramname"> <em>klen</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void ** </td>
<td class="paramname"> <em>val</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the current entry's details from the iteration state. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>hi</em> </td><td>The iteration state </td></tr>
<tr><td valign="top"></td><td valign="top"><em>key</em> </td><td>Return pointer for the pointer to the key. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>klen</em> </td><td>Return pointer for the key length. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>val</em> </td><td>Return pointer for the associated value. </td></tr>
</table>
</dl>
<dl compact><dt><b>Remarks:</b></dt><dd>The return pointers should point to a variable that will be set to the corresponding data, or they may be NULL if the data isn't interesting. </dd></dl>
</div>
</div><p>
<a class="anchor" name="gb610fd182aa2f60a282954f6bc3ecda1"></a><!-- doxytag: member="apr_hash.h::apr_hashfunc_default" ref="gb610fd182aa2f60a282954f6bc3ecda1" args="(const char *key, apr_ssize_t *klen)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">unsigned int apr_hashfunc_default </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>key</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_ssize_t * </td>
<td class="paramname"> <em>klen</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The default hash function.
</div>
</div><p>
<hr size="1"><address style="align: right;"><small>Generated on Tue May 31 12:43:39 2011 for Apache Portable Runtime by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.7 </small></address>
</body>
</html>
distrib
>
Scientific%20Linux
>
5x
>
x86_64
>
by-pkgid
>
243222a43997d44a8ac787d018c9535c
>
files
>
130
