<!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">
</head><body>
<!-- Generated by Doxygen 1.3.9.1 -->
<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data Structures</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Data Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div>
<h1>Hash Tables<br>
<small>
[<a class="el" href="group__APR.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#ga16">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#ga0">apr_hash_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="el" href="group__apr__hash.html#ga1">apr_hash_index_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#ga1">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#ga2">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#ga3">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#ga0">apr_hash_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#ga4">apr_hash_make</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *pool)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#ga5">apr_hash_make_custom</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *pool, <a class="el" href="group__apr__hash.html#ga2">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#ga0">apr_hash_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#ga6">apr_hash_copy</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *pool, const <a class="el" href="group__apr__hash.html#ga0">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#ga7">apr_hash_set</a> (<a class="el" href="group__apr__hash.html#ga0">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#ga8">apr_hash_get</a> (<a class="el" href="group__apr__hash.html#ga0">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#ga1">apr_hash_index_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#ga9">apr_hash_first</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> *ht)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__hash.html#ga1">apr_hash_index_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#ga10">apr_hash_next</a> (<a class="el" href="group__apr__hash.html#ga1">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#ga11">apr_hash_this</a> (<a class="el" href="group__apr__hash.html#ga1">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#ga12">apr_hash_count</a> (<a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> *ht)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#ga13">apr_hash_overlay</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, const <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> *overlay, const <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> *base)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#ga14">apr_hash_merge</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, const <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> *h1, const <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> *h2, void *(*merger)(<a class="el" href="group__apr__pools.html#ga0">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#ga0">apr_pool_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__hash.html#ga15">apr_hash_pool_get</a> (const <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> *thehash)</td></tr>
</table>
<hr><h2>Define Documentation</h2>
<a class="anchor" name="ga16" doxytag="apr_hash.h::APR_HASH_KEY_STRING"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">#define APR_HASH_KEY_STRING (-1) </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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#ga11">apr_hash_this()</a> will return the NUL-term'd key. </dd></dl>
</td>
</tr>
</table>
<hr><h2>Typedef Documentation</h2>
<a class="anchor" name="ga1" doxytag="apr_hash.h::apr_hash_index_t"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">typedef struct <a class="el" href="group__apr__hash.html#ga1">apr_hash_index_t</a> <a class="el" href="group__apr__hash.html#ga1">apr_hash_index_t</a> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Abstract type for scanning hash tables. </td>
</tr>
</table>
<a class="anchor" name="ga0" doxytag="apr_hash.h::apr_hash_t"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">typedef struct <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Abstract type for hash tables. </td>
</tr>
</table>
<a class="anchor" name="ga2" doxytag="apr_hash.h::apr_hashfunc_t"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">typedef unsigned int(* <a class="el" href="group__apr__hash.html#ga2">apr_hashfunc_t</a>)(const char *key, apr_ssize_t *klen) </td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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>
</td>
</tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="ga6" doxytag="apr_hash.h::apr_hash_copy"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a>* apr_hash_copy </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>pool</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td>
<td class="mdname" nowrap> <em>h</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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>
</td>
</tr>
</table>
<a class="anchor" name="ga12" doxytag="apr_hash.h::apr_hash_count"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">unsigned int apr_hash_count </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>ht</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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>
</td>
</tr>
</table>
<a class="anchor" name="ga9" doxytag="apr_hash.h::apr_hash_first"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga1">apr_hash_index_t</a>* apr_hash_first </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td>
<td class="mdname" nowrap> <em>ht</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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> </td>
</tr>
</table>
<a class="anchor" name="ga8" doxytag="apr_hash.h::apr_hash_get"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void* apr_hash_get </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td>
<td class="mdname" nowrap> <em>ht</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const void * </td>
<td class="mdname" nowrap> <em>key</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>apr_ssize_t </td>
<td class="mdname" nowrap> <em>klen</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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>
</td>
</tr>
</table>
<a class="anchor" name="ga4" doxytag="apr_hash.h::apr_hash_make"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a>* apr_hash_make </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>pool</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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>
</td>
</tr>
</table>
<a class="anchor" name="ga5" doxytag="apr_hash.h::apr_hash_make_custom"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a>* apr_hash_make_custom </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>pool</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap><a class="el" href="group__apr__hash.html#ga2">apr_hashfunc_t</a> </td>
<td class="mdname" nowrap> <em>hash_func</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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>
</td>
</tr>
</table>
<a class="anchor" name="ga14" doxytag="apr_hash.h::apr_hash_merge"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a>* apr_hash_merge </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td>
<td class="mdname" nowrap> <em>h1</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td>
<td class="mdname" nowrap> <em>h2</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>void *(*)(<a class="el" href="group__apr__pools.html#ga0">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="mdname" nowrap> <em>merger</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const void * </td>
<td class="mdname" nowrap> <em>data</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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#ga13">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>
</td>
</tr>
</table>
<a class="anchor" name="ga10" doxytag="apr_hash.h::apr_hash_next"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga1">apr_hash_index_t</a>* apr_hash_next </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga1">apr_hash_index_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>hi</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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>
</td>
</tr>
</table>
<a class="anchor" name="ga13" doxytag="apr_hash.h::apr_hash_overlay"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a>* apr_hash_overlay </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td>
<td class="mdname" nowrap> <em>overlay</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td>
<td class="mdname" nowrap> <em>base</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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>
</td>
</tr>
</table>
<a class="anchor" name="ga15" doxytag="apr_hash.h::apr_hash_pool_get"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a>* apr_hash_pool_get </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const <a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td>
<td class="mdname1" valign="top" nowrap> <em>thehash</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Get a pointer to the pool which the hash table was created in </td>
</tr>
</table>
<a class="anchor" name="ga7" doxytag="apr_hash.h::apr_hash_set"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void apr_hash_set </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga0">apr_hash_t</a> * </td>
<td class="mdname" nowrap> <em>ht</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const void * </td>
<td class="mdname" nowrap> <em>key</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>apr_ssize_t </td>
<td class="mdname" nowrap> <em>klen</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const void * </td>
<td class="mdname" nowrap> <em>val</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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>
</td>
</tr>
</table>
<a class="anchor" name="ga11" doxytag="apr_hash.h::apr_hash_this"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void apr_hash_this </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__hash.html#ga1">apr_hash_index_t</a> * </td>
<td class="mdname" nowrap> <em>hi</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const void ** </td>
<td class="mdname" nowrap> <em>key</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>apr_ssize_t * </td>
<td class="mdname" nowrap> <em>klen</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>void ** </td>
<td class="mdname" nowrap> <em>val</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<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>
</td>
</tr>
</table>
<a class="anchor" name="ga3" doxytag="apr_hash.h::apr_hashfunc_default"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">unsigned int apr_hashfunc_default </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname" nowrap> <em>key</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>apr_ssize_t * </td>
<td class="mdname" nowrap> <em>klen</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
The default hash function. </td>
</tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Sun Mar 20 19:52:27 2005 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.3.9.1 </small></address>
</body>
</html>
