<!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.5"/>
<title>Apache Portable Runtime: Table and Array Functions</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="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</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">Apache Portable Runtime
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.5 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</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>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
</div><!-- top -->
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Macros</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(10)"><span class="SelectionMark"> </span>Pages</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="summary">
<a href="#nested-classes">Data Structures</a> |
<a href="#define-members">Macros</a> |
<a href="#typedef-members">Typedefs</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Table and Array Functions<div class="ingroups"><a class="el" href="group___a_p_r.html">Apache Portability Runtime library</a></div></div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structapr__table__entry__t.html">apr_table_entry_t</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:ga84066caaa4c7632671af18c229809fc4"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga84066caaa4c7632671af18c229809fc4">APR_ARRAY_IDX</a>(ary, i, type)   (((type *)(ary)->elts)[i])</td></tr>
<tr class="separator:ga84066caaa4c7632671af18c229809fc4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1833b0f940ec03d0b95926812152e1ca"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga1833b0f940ec03d0b95926812152e1ca">APR_ARRAY_PUSH</a>(ary, type)   (*((type *)<a class="el" href="group__apr__tables.html#gac08267b32905197dd02ffff3314d9603">apr_array_push</a>(ary)))</td></tr>
<tr class="separator:ga1833b0f940ec03d0b95926812152e1ca"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga867455bb7008872e03b08c0742f9698c"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga867455bb7008872e03b08c0742f9698c">APR_OVERLAP_TABLES_SET</a>   (0)</td></tr>
<tr class="separator:ga867455bb7008872e03b08c0742f9698c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga553eea6eb6fea4bafaf4cbd7acafdf5f"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga553eea6eb6fea4bafaf4cbd7acafdf5f">APR_OVERLAP_TABLES_MERGE</a>   (1)</td></tr>
<tr class="separator:ga553eea6eb6fea4bafaf4cbd7acafdf5f"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr class="memitem:gad7ea82d6608a4a633fc3775694ab71e4"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a></td></tr>
<tr class="separator:gad7ea82d6608a4a633fc3775694ab71e4"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga63e76617a1cd3828bbaefcbf93928ec2"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga63e76617a1cd3828bbaefcbf93928ec2">apr_array_header_t</a></td></tr>
<tr class="separator:ga63e76617a1cd3828bbaefcbf93928ec2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac7e0151b714e58b75c597dafed75df3f"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structapr__table__entry__t.html">apr_table_entry_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gac7e0151b714e58b75c597dafed75df3f">apr_table_entry_t</a></td></tr>
<tr class="separator:gac7e0151b714e58b75c597dafed75df3f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga0a59d6b321ade650c7cfa31d7fa93dcc"><td class="memItemLeft" align="right" valign="top">typedef int( </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga0a59d6b321ade650c7cfa31d7fa93dcc">apr_table_do_callback_fn_t</a> )(void *rec, const char *key, const char *value)</td></tr>
<tr class="separator:ga0a59d6b321ade650c7cfa31d7fa93dcc"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:gaea3005541cce67481f48ab201b5c0cf3"><td class="memItemLeft" align="right" valign="top">const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gaea3005541cce67481f48ab201b5c0cf3">apr_table_elts</a> (const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t)</td></tr>
<tr class="separator:gaea3005541cce67481f48ab201b5c0cf3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga198e52683a86ecf8df9642990c220ff7"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga198e52683a86ecf8df9642990c220ff7">apr_is_empty_table</a> (const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t)</td></tr>
<tr class="separator:ga198e52683a86ecf8df9642990c220ff7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gacae19f5b2182d5813f4ef3050f82ff29"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gacae19f5b2182d5813f4ef3050f82ff29">apr_is_empty_array</a> (const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *a)</td></tr>
<tr class="separator:gacae19f5b2182d5813f4ef3050f82ff29"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8f4308b5a1636ec06544113a9c283304"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga8f4308b5a1636ec06544113a9c283304">apr_array_make</a> (<a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p, int nelts, int elt_size)</td></tr>
<tr class="separator:ga8f4308b5a1636ec06544113a9c283304"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac08267b32905197dd02ffff3314d9603"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gac08267b32905197dd02ffff3314d9603">apr_array_push</a> (<a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *arr)</td></tr>
<tr class="separator:gac08267b32905197dd02ffff3314d9603"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad1ab3e0ca2de25a7ff2fbed393380972"><td class="memItemLeft" align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gad1ab3e0ca2de25a7ff2fbed393380972">apr_array_pop</a> (<a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *arr)</td></tr>
<tr class="separator:gad1ab3e0ca2de25a7ff2fbed393380972"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6a6436840256ed8a47b5d6be4ea2ae03"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga6a6436840256ed8a47b5d6be4ea2ae03">apr_array_clear</a> (<a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *arr)</td></tr>
<tr class="separator:ga6a6436840256ed8a47b5d6be4ea2ae03"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga532e0f0e4d1e2b7243ebdb7eb1f783c7"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga532e0f0e4d1e2b7243ebdb7eb1f783c7">apr_array_cat</a> (<a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *dst, const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *src)</td></tr>
<tr class="separator:ga532e0f0e4d1e2b7243ebdb7eb1f783c7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga327e2d5e29fa49d5a2a31295a6932950"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga327e2d5e29fa49d5a2a31295a6932950">apr_array_copy</a> (<a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p, const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *arr)</td></tr>
<tr class="separator:ga327e2d5e29fa49d5a2a31295a6932950"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6203e9f731bf43e7373857c38d04397d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga6203e9f731bf43e7373857c38d04397d">apr_array_copy_hdr</a> (<a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p, const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *arr)</td></tr>
<tr class="separator:ga6203e9f731bf43e7373857c38d04397d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga893cade58c5fabecb593cb4ffac7e9be"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga893cade58c5fabecb593cb4ffac7e9be">apr_array_append</a> (<a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p, const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *first, const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *second)</td></tr>
<tr class="separator:ga893cade58c5fabecb593cb4ffac7e9be"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6232817e4a32ee5619c99fe55e145c7a"><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga6232817e4a32ee5619c99fe55e145c7a">apr_array_pstrcat</a> (<a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p, const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *arr, const char sep)</td></tr>
<tr class="separator:ga6232817e4a32ee5619c99fe55e145c7a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga7b0a16a1388c68e66bff32190cf092f6"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga7b0a16a1388c68e66bff32190cf092f6">apr_table_make</a> (<a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p, int nelts)</td></tr>
<tr class="separator:ga7b0a16a1388c68e66bff32190cf092f6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gae69f2b0b593bcdbf4c678a0f3dfde5f3"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gae69f2b0b593bcdbf4c678a0f3dfde5f3">apr_table_copy</a> (<a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p, const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t)</td></tr>
<tr class="separator:gae69f2b0b593bcdbf4c678a0f3dfde5f3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga7e8bc16b272840302545ed4a6a082a6e"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga7e8bc16b272840302545ed4a6a082a6e">apr_table_clone</a> (<a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p, const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t)</td></tr>
<tr class="separator:ga7e8bc16b272840302545ed4a6a082a6e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga03f03de545f9a18e25420f261938ffea"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga03f03de545f9a18e25420f261938ffea">apr_table_clear</a> (<a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t)</td></tr>
<tr class="separator:ga03f03de545f9a18e25420f261938ffea"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga4db13e3915c6b9a3142b175d4c15d915"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga4db13e3915c6b9a3142b175d4c15d915">apr_table_get</a> (const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t, const char *key)</td></tr>
<tr class="separator:ga4db13e3915c6b9a3142b175d4c15d915"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa52177e485731ec599d04f863872c5f3"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gaa52177e485731ec599d04f863872c5f3">apr_table_getm</a> (<a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p, const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t, const char *key)</td></tr>
<tr class="separator:gaa52177e485731ec599d04f863872c5f3"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaf101d92c2f6343cdf4ec062ff416f244"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gaf101d92c2f6343cdf4ec062ff416f244">apr_table_set</a> (<a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t, const char *key, const char *val)</td></tr>
<tr class="separator:gaf101d92c2f6343cdf4ec062ff416f244"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1fe7bb25d4027bb79d3c2bb41d8d8b75"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga1fe7bb25d4027bb79d3c2bb41d8d8b75">apr_table_setn</a> (<a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t, const char *key, const char *val)</td></tr>
<tr class="separator:ga1fe7bb25d4027bb79d3c2bb41d8d8b75"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab0df7a237feb4cd9beed201f4e236127"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gab0df7a237feb4cd9beed201f4e236127">apr_table_unset</a> (<a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t, const char *key)</td></tr>
<tr class="separator:gab0df7a237feb4cd9beed201f4e236127"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad5d10eca30b76fb44d999b4dfda8d632"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gad5d10eca30b76fb44d999b4dfda8d632">apr_table_merge</a> (<a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t, const char *key, const char *val)</td></tr>
<tr class="separator:gad5d10eca30b76fb44d999b4dfda8d632"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1d50805448114c476cfcd00d5ee3e3a8"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga1d50805448114c476cfcd00d5ee3e3a8">apr_table_mergen</a> (<a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t, const char *key, const char *val)</td></tr>
<tr class="separator:ga1d50805448114c476cfcd00d5ee3e3a8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab2ea874754a0fbf139b7316c1f837f12"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gab2ea874754a0fbf139b7316c1f837f12">apr_table_add</a> (<a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t, const char *key, const char *val)</td></tr>
<tr class="separator:gab2ea874754a0fbf139b7316c1f837f12"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaff9fdbd8f499f0dfb07123230e19ea54"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#gaff9fdbd8f499f0dfb07123230e19ea54">apr_table_addn</a> (<a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t, const char *key, const char *val)</td></tr>
<tr class="separator:gaff9fdbd8f499f0dfb07123230e19ea54"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga783b5c439d46c109bb45e7bc1a6d7ef2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga783b5c439d46c109bb45e7bc1a6d7ef2">apr_table_overlay</a> (<a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p, const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *overlay, const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *base)</td></tr>
<tr class="separator:ga783b5c439d46c109bb45e7bc1a6d7ef2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5917e542ae910961ee48b0ec2d09a879"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga5917e542ae910961ee48b0ec2d09a879">apr_table_do</a> (<a class="el" href="group__apr__tables.html#ga0a59d6b321ade650c7cfa31d7fa93dcc">apr_table_do_callback_fn_t</a> *comp, void *rec, const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t,...)</td></tr>
<tr class="separator:ga5917e542ae910961ee48b0ec2d09a879"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga753c5247c9cd7f90c8958b64d9b6aeae"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga753c5247c9cd7f90c8958b64d9b6aeae">apr_table_vdo</a> (<a class="el" href="group__apr__tables.html#ga0a59d6b321ade650c7cfa31d7fa93dcc">apr_table_do_callback_fn_t</a> *comp, void *rec, const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t, va_list vp)</td></tr>
<tr class="separator:ga753c5247c9cd7f90c8958b64d9b6aeae"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga603ebc9b97703b855f8ad77640165372"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga603ebc9b97703b855f8ad77640165372">apr_table_overlap</a> (<a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *a, const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *b, unsigned flags)</td></tr>
<tr class="separator:ga603ebc9b97703b855f8ad77640165372"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga7f2a652a0cdaf8c20588823c97a3007f"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__tables.html#ga7f2a652a0cdaf8c20588823c97a3007f">apr_table_compress</a> (<a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *t, unsigned flags)</td></tr>
<tr class="separator:ga7f2a652a0cdaf8c20588823c97a3007f"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>Arrays are used to store data which is referenced sequentially or as a stack. Functions are provided to push and pop individual elements as well as to operate on the entire array.</p>
<p>Tables are used to store data which can be referenced by key. Limited capabilities are provided for tables with multiple elements which share a key; while key lookup will return only a single element, iteration is available. Additionally, a table can be compressed to resolve duplicates.</p>
<p>Both arrays and tables may store string or binary data; some features, such as concatenation or merging of elements, work only for string data. </p>
<h2 class="groupheader">Macro Definition Documentation</h2>
<a class="anchor" id="ga84066caaa4c7632671af18c229809fc4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_ARRAY_IDX</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">ary, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">i, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">type </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td>   (((type *)(ary)->elts)[i])</td>
</tr>
</table>
</div><div class="memdoc">
<p>A helper macro for accessing a member of an APR array.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">ary</td><td>the array </td></tr>
<tr><td class="paramname">i</td><td>the index into the array to return </td></tr>
<tr><td class="paramname">type</td><td>the type of the objects stored in the array</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>the item at index i </dd></dl>
</div>
</div>
<a class="anchor" id="ga1833b0f940ec03d0b95926812152e1ca"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_ARRAY_PUSH</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">ary, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname">type </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td>   (*((type *)<a class="el" href="group__apr__tables.html#gac08267b32905197dd02ffff3314d9603">apr_array_push</a>(ary)))</td>
</tr>
</table>
</div><div class="memdoc">
<p>A helper macro for pushing elements into an APR array.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">ary</td><td>the array </td></tr>
<tr><td class="paramname">type</td><td>the type of the objects stored in the array</td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>the location where the new object should be placed </dd></dl>
</div>
</div>
<a class="anchor" id="ga553eea6eb6fea4bafaf4cbd7acafdf5f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_OVERLAP_TABLES_MERGE   (1)</td>
</tr>
</table>
</div><div class="memdoc">
<p>flag for overlap to use apr_table_mergen </p>
</div>
</div>
<a class="anchor" id="ga867455bb7008872e03b08c0742f9698c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define APR_OVERLAP_TABLES_SET   (0)</td>
</tr>
</table>
</div><div class="memdoc">
<p>flag for overlap to use apr_table_setn </p>
</div>
</div>
<h2 class="groupheader">Typedef Documentation</h2>
<a class="anchor" id="ga63e76617a1cd3828bbaefcbf93928ec2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> </dd></dl>
</div>
</div>
<a class="anchor" id="ga0a59d6b321ade650c7cfa31d7fa93dcc"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef int( apr_table_do_callback_fn_t)(void *rec, const char *key, const char *value)</td>
</tr>
</table>
</div><div class="memdoc">
<p>Declaration prototype for the iterator callback function of <a class="el" href="group__apr__tables.html#ga5917e542ae910961ee48b0ec2d09a879">apr_table_do()</a> and <a class="el" href="group__apr__tables.html#ga753c5247c9cd7f90c8958b64d9b6aeae">apr_table_vdo()</a>. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">rec</td><td>The data passed as the first argument to apr_table_[v]do() </td></tr>
<tr><td class="paramname">key</td><td>The key from this iteration of the table </td></tr>
<tr><td class="paramname">value</td><td>The value from this iteration of the table </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>Iteration continues while this callback function returns non-zero. To export the callback function for apr_table_[v]do() it must be declared in the _NONSTD convention. </dd></dl>
</div>
</div>
<a class="anchor" id="gac7e0151b714e58b75c597dafed75df3f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="structapr__table__entry__t.html">apr_table_entry_t</a> <a class="el" href="structapr__table__entry__t.html">apr_table_entry_t</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>The (opaque) structure for string-content tables. </p>
</div>
</div>
<a class="anchor" id="gad7ea82d6608a4a633fc3775694ab71e4"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>the table abstract data type </p>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="ga893cade58c5fabecb593cb4ffac7e9be"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a>* apr_array_append </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">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="structapr__array__header__t.html">apr_array_header_t</a> * </td>
<td class="paramname"><em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td>
<td class="paramname"><em>second</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Append one array to the end of another, creating a new array in the process. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">p</td><td>The pool to allocate the new array out of </td></tr>
<tr><td class="paramname">first</td><td>The array to put first in the new array. </td></tr>
<tr><td class="paramname">second</td><td>The array to put second in the new array. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A new array containing the data from the two arrays passed in. </dd></dl>
</div>
</div>
<a class="anchor" id="ga532e0f0e4d1e2b7243ebdb7eb1f783c7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_array_cat </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td>
<td class="paramname"><em>dst</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td>
<td class="paramname"><em>src</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Concatenate two arrays together. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dst</td><td>The destination array, and the one to go first in the combined array </td></tr>
<tr><td class="paramname">src</td><td>The source array to add to the destination array </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga6a6436840256ed8a47b5d6be4ea2ae03"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_array_clear </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td>
<td class="paramname"><em>arr</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Remove all elements from an array. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">arr</td><td>The array to remove all elements from. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>As the underlying storage is allocated from a pool, no memory is freed by this operation, but is available for reuse. </dd></dl>
</div>
</div>
<a class="anchor" id="ga327e2d5e29fa49d5a2a31295a6932950"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a>* apr_array_copy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">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="structapr__array__header__t.html">apr_array_header_t</a> * </td>
<td class="paramname"><em>arr</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy the entire array. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">p</td><td>The pool to allocate the copy of the array out of </td></tr>
<tr><td class="paramname">arr</td><td>The array to copy </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>An exact copy of the array passed in </dd></dl>
<dl class="section remark"><dt>Remarks</dt><dd>The alternate apr_array_copy_hdr copies only the header, and arranges for the elements to be copied if (and only if) the code subsequently does a push or arraycat. </dd></dl>
</div>
</div>
<a class="anchor" id="ga6203e9f731bf43e7373857c38d04397d"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a>* apr_array_copy_hdr </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">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="structapr__array__header__t.html">apr_array_header_t</a> * </td>
<td class="paramname"><em>arr</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Copy the headers of the array, and arrange for the elements to be copied if and only if the code subsequently does a push or arraycat. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">p</td><td>The pool to allocate the copy of the array out of </td></tr>
<tr><td class="paramname">arr</td><td>The array to copy </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>An exact copy of the array passed in </dd></dl>
<dl class="section remark"><dt>Remarks</dt><dd>The alternate apr_array_copy copies the <em>entire</em> array. </dd></dl>
</div>
</div>
<a class="anchor" id="ga8f4308b5a1636ec06544113a9c283304"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a>* apr_array_make </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> * </td>
<td class="paramname"><em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>nelts</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>elt_size</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Create an array. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">p</td><td>The pool to allocate the memory out of </td></tr>
<tr><td class="paramname">nelts</td><td>the number of elements in the initial array </td></tr>
<tr><td class="paramname">elt_size</td><td>The size of each element in the array. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The new array </dd></dl>
</div>
</div>
<a class="anchor" id="gad1ab3e0ca2de25a7ff2fbed393380972"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* apr_array_pop </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td>
<td class="paramname"><em>arr</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Remove an element from an array (as a first-in, last-out stack). </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">arr</td><td>The array to remove an element from. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Location of the element in the array. </dd></dl>
<dl class="section remark"><dt>Remarks</dt><dd>If there are no elements in the array, NULL is returned. </dd></dl>
</div>
</div>
<a class="anchor" id="ga6232817e4a32ee5619c99fe55e145c7a"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">char* apr_array_pstrcat </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">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="structapr__array__header__t.html">apr_array_header_t</a> * </td>
<td class="paramname"><em>arr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char </td>
<td class="paramname"><em>sep</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Generate a new string from the apr_pool_t containing the concatenated sequence of substrings referenced as elements within the array. The string will be empty if all substrings are empty or null, or if there are no elements in the array. If sep is non-NUL, it will be inserted between elements as a separator. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">p</td><td>The pool to allocate the string out of </td></tr>
<tr><td class="paramname">arr</td><td>The array to generate the string from </td></tr>
<tr><td class="paramname">sep</td><td>The separator to use </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A string containing all of the data in the array. </dd></dl>
</div>
</div>
<a class="anchor" id="gac08267b32905197dd02ffff3314d9603"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* apr_array_push </td>
<td>(</td>
<td class="paramtype"><a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td>
<td class="paramname"><em>arr</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Add a new element to an array (as a first-in, last-out stack). </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">arr</td><td>The array to add an element to. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>Location for the new element in the array. </dd></dl>
<dl class="section remark"><dt>Remarks</dt><dd>If there are no free spots in the array, then this function will allocate new space for the new element. </dd></dl>
</div>
</div>
<a class="anchor" id="gacae19f5b2182d5813f4ef3050f82ff29"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_is_empty_array </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> * </td>
<td class="paramname"><em>a</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Determine if the array is empty (either NULL or having no elements). </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">a</td><td>The array to check </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>True if empty, False otherwise </dd></dl>
</div>
</div>
<a class="anchor" id="ga198e52683a86ecf8df9642990c220ff7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_is_empty_table </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Determine if the table is empty (either NULL or having no elements). </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>The table to check </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>True if empty, False otherwise </dd></dl>
</div>
</div>
<a class="anchor" id="gab2ea874754a0fbf139b7316c1f837f12"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_table_add </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></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">const char * </td>
<td class="paramname"><em>val</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Add data to a table, regardless of whether there is another element with the same key. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>The table to add to </td></tr>
<tr><td class="paramname">key</td><td>The key to use </td></tr>
<tr><td class="paramname">val</td><td>The value to add. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>When adding data, this function makes a copy of both the key and the value. </dd></dl>
</div>
</div>
<a class="anchor" id="gaff9fdbd8f499f0dfb07123230e19ea54"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_table_addn </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></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">const char * </td>
<td class="paramname"><em>val</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Add data to a table, regardless of whether there is another element with the same key. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>The table to add to </td></tr>
<tr><td class="paramname">key</td><td>The key to use </td></tr>
<tr><td class="paramname">val</td><td>The value to add. </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>When adding data, this function does not make a copy of the key or the value, so care should be taken to ensure that the values will not change after they have been added. </dd></dl>
</div>
</div>
<a class="anchor" id="ga03f03de545f9a18e25420f261938ffea"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_table_clear </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Delete all of the elements from a table. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>The table to clear </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga7e8bc16b272840302545ed4a6a082a6e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a>* apr_table_clone </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">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__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Create a new table whose contents are deep copied from the given table. A deep copy operation copies all fields, and makes copies of dynamically allocated memory pointed to by the fields. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">p</td><td>The pool to allocate the new table out of </td></tr>
<tr><td class="paramname">t</td><td>The table to clone </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A deep copy of the table passed in </dd></dl>
</div>
</div>
<a class="anchor" id="ga7f2a652a0cdaf8c20588823c97a3007f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_table_compress </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>flags</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Eliminate redundant entries in a table by either overwriting or merging duplicates.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>Table. </td></tr>
<tr><td class="paramname">flags</td><td>APR_OVERLAP_TABLES_MERGE to merge, or APR_OVERLAP_TABLES_SET to overwrite </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>When merging duplicates, the two values are concatenated, separated by the string ", ". </dd></dl>
</div>
</div>
<a class="anchor" id="gae69f2b0b593bcdbf4c678a0f3dfde5f3"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a>* apr_table_copy </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">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__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Create a new table and copy another table into it. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">p</td><td>The pool to allocate the new table out of </td></tr>
<tr><td class="paramname">t</td><td>The table to copy </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A copy of the table passed in </dd></dl>
<dl class="section warning"><dt>Warning</dt><dd>The table keys and respective values are not copied </dd></dl>
</div>
</div>
<a class="anchor" id="ga5917e542ae910961ee48b0ec2d09a879"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_table_do </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#ga0a59d6b321ade650c7cfa31d7fa93dcc">apr_table_do_callback_fn_t</a> * </td>
<td class="paramname"><em>comp</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>rec</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"><em>...</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Iterate over a table running the provided function once for every element in the table. The varargs array must be a list of zero or more (char *) keys followed by a NULL pointer. If zero keys are given, the </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">comp</td><td>function will be invoked for every element in the table. Otherwise, the function is invoked only for those elements matching the keys specified.</td></tr>
</table>
</dd>
</dl>
<p>If an invocation of the </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">comp</td><td>function returns zero, iteration will continue using the next specified key, if any.</td></tr>
<tr><td class="paramname">comp</td><td>The function to run </td></tr>
<tr><td class="paramname">rec</td><td>The data to pass as the first argument to the function </td></tr>
<tr><td class="paramname">t</td><td>The table to iterate over </td></tr>
<tr><td class="paramname">...</td><td>A varargs array of zero or more (char *) keys followed by NULL </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>FALSE if one of the comp() iterations returned zero; TRUE if all iterations returned non-zero </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="group__apr__tables.html#ga0a59d6b321ade650c7cfa31d7fa93dcc">apr_table_do_callback_fn_t</a> </dd></dl>
</div>
</div>
<a class="anchor" id="gaea3005541cce67481f48ab201b5c0cf3"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="structapr__array__header__t.html">apr_array_header_t</a>* apr_table_elts </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the elements from a table. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>The table </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>An array containing the contents of the table </dd></dl>
</div>
</div>
<a class="anchor" id="ga4db13e3915c6b9a3142b175d4c15d915"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* apr_table_get </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>key</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the value associated with a given key from the table. After this call, the data is still in the table. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>The table to search for the key </td></tr>
<tr><td class="paramname">key</td><td>The key to search for (case does not matter) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The value associated with the key, or NULL if the key does not exist. </dd></dl>
</div>
</div>
<a class="anchor" id="gaa52177e485731ec599d04f863872c5f3"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* apr_table_getm </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">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__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>key</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get values associated with a given key from the table. If more than one value exists, return a comma separated list of values. After this call, the data is still in the table. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">p</td><td>The pool to allocate the combined value from, if necessary </td></tr>
<tr><td class="paramname">t</td><td>The table to search for the key </td></tr>
<tr><td class="paramname">key</td><td>The key to search for (case does not matter) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The value associated with the key, or NULL if the key does not exist. </dd></dl>
</div>
</div>
<a class="anchor" id="ga7b0a16a1388c68e66bff32190cf092f6"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a>* apr_table_make </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> * </td>
<td class="paramname"><em>p</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>nelts</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Make a new table. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">p</td><td>The pool to allocate the pool out of </td></tr>
<tr><td class="paramname">nelts</td><td>The number of elements in the initial table. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The new table. </dd></dl>
<dl class="section warning"><dt>Warning</dt><dd>This table can only store text data </dd></dl>
</div>
</div>
<a class="anchor" id="gad5d10eca30b76fb44d999b4dfda8d632"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_table_merge </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></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">const char * </td>
<td class="paramname"><em>val</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Add data to a table by merging the value with data that has already been stored. The merging is done by concatenating the two values, separated by the string ", ". </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>The table to search for the data </td></tr>
<tr><td class="paramname">key</td><td>The key to merge data for (case does not matter) </td></tr>
<tr><td class="paramname">val</td><td>The data to add </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>If the key is not found, then this function acts like apr_table_add </dd></dl>
</div>
</div>
<a class="anchor" id="ga1d50805448114c476cfcd00d5ee3e3a8"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_table_mergen </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></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">const char * </td>
<td class="paramname"><em>val</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Add data to a table by merging the value with data that has already been stored. The merging is done by concatenating the two values, separated by the string ", ". </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>The table to search for the data </td></tr>
<tr><td class="paramname">key</td><td>The key to merge data for (case does not matter) </td></tr>
<tr><td class="paramname">val</td><td>The data to add </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>If the key is not found, then this function acts like apr_table_addn </dd></dl>
</div>
</div>
<a class="anchor" id="ga603ebc9b97703b855f8ad77640165372"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_table_overlap </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>a</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>b</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>flags</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>For each element in table b, either use setn or mergen to add the data to table a. Which method is used is determined by the flags passed in. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">a</td><td>The table to add the data to. </td></tr>
<tr><td class="paramname">b</td><td>The table to iterate over, adding its data to table a </td></tr>
<tr><td class="paramname">flags</td><td>How to add the table to table a. One of: APR_OVERLAP_TABLES_SET Use apr_table_setn APR_OVERLAP_TABLES_MERGE Use apr_table_mergen </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>When merging duplicates, the two values are concatenated, separated by the string ", ". </dd>
<dd>
This function is highly optimized, and uses less memory and CPU cycles than a function that just loops through table b calling other functions. Conceptually, apr_table_overlap does this:</dd></dl>
<pre>
<a class="el" href="structapr__array__header__t.html">apr_array_header_t</a> *barr = apr_table_elts(b);
<a class="el" href="structapr__table__entry__t.html">apr_table_entry_t</a> *belt = (<a class="el" href="structapr__table__entry__t.html">apr_table_entry_t</a> *)barr->elts;
int i;</pre><pre> for (i = 0; i < barr->nelts; ++i) {
if (flags & APR_OVERLAP_TABLES_MERGE) {
apr_table_mergen(a, belt[i].key, belt[i].val);
}
else {
apr_table_setn(a, belt[i].key, belt[i].val);
}
}
</pre><p>Except that it is more efficient (less space and cpu-time) especially when b has many elements.</p>
<p>Notice the assumptions on the keys and values in b – they must be in an ancestor of a's pool. In practice b and a are usually from the same pool. </p>
</div>
</div>
<a class="anchor" id="ga783b5c439d46c109bb45e7bc1a6d7ef2"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a>* apr_table_overlay </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__pools.html#gaf137f28edcf9a086cd6bc36c20d7cdfb">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__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_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__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>base</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Merge two tables into one new table. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">p</td><td>The pool to use for the new table </td></tr>
<tr><td class="paramname">overlay</td><td>The first table to put in the new table </td></tr>
<tr><td class="paramname">base</td><td>The table to add at the end of the new table </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A new table containing all of the data from the two passed in </dd></dl>
</div>
</div>
<a class="anchor" id="gaf101d92c2f6343cdf4ec062ff416f244"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_table_set </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></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">const char * </td>
<td class="paramname"><em>val</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Add a key/value pair to a table. If another element already exists with the same key, this will overwrite the old data. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>The table to add the data to. </td></tr>
<tr><td class="paramname">key</td><td>The key to use (case does not matter) </td></tr>
<tr><td class="paramname">val</td><td>The value to add </td></tr>
</table>
</dd>
</dl>
<dl class="section remark"><dt>Remarks</dt><dd>When adding data, this function makes a copy of both the key and the value. </dd></dl>
</div>
</div>
<a class="anchor" id="ga1fe7bb25d4027bb79d3c2bb41d8d8b75"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_table_setn </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></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">const char * </td>
<td class="paramname"><em>val</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Add a key/value pair to a table. If another element already exists with the same key, this will overwrite the old data. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>The table to add the data to. </td></tr>
<tr><td class="paramname">key</td><td>The key to use (case does not matter) </td></tr>
<tr><td class="paramname">val</td><td>The value to add </td></tr>
</table>
</dd>
</dl>
<dl class="section warning"><dt>Warning</dt><dd>When adding data, this function does not make a copy of the key or the value, so care should be taken to ensure that the values will not change after they have been added.. </dd></dl>
</div>
</div>
<a class="anchor" id="gab0df7a237feb4cd9beed201f4e236127"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void apr_table_unset </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>key</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Remove data from the table. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">t</td><td>The table to remove data from </td></tr>
<tr><td class="paramname">key</td><td>The key of the data being removed (case does not matter) </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga753c5247c9cd7f90c8958b64d9b6aeae"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_table_vdo </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__apr__tables.html#ga0a59d6b321ade650c7cfa31d7fa93dcc">apr_table_do_callback_fn_t</a> * </td>
<td class="paramname"><em>comp</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>rec</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> * </td>
<td class="paramname"><em>t</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"><em>vp</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Iterate over a table running the provided function once for every element in the table. The </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">vp</td><td>varargs parameter must be a list of zero or more (char *) keys followed by a NULL pointer. If zero keys are given, the </td></tr>
<tr><td class="paramname">comp</td><td>function will be invoked for every element in the table. Otherwise, the function is invoked only for those elements matching the keys specified.</td></tr>
</table>
</dd>
</dl>
<p>If an invocation of the </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">comp</td><td>function returns zero, iteration will continue using the next specified key, if any.</td></tr>
<tr><td class="paramname">comp</td><td>The function to run </td></tr>
<tr><td class="paramname">rec</td><td>The data to pass as the first argument to the function </td></tr>
<tr><td class="paramname">t</td><td>The table to iterate over </td></tr>
<tr><td class="paramname">vp</td><td>List of zero or more (char *) keys followed by NULL </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>FALSE if one of the comp() iterations returned zero; TRUE if all iterations returned non-zero </dd></dl>
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="group__apr__tables.html#ga0a59d6b321ade650c7cfa31d7fa93dcc">apr_table_do_callback_fn_t</a> </dd></dl>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Sat Nov 30 2013 15:32:17 for Apache Portable Runtime by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.5
</small></address>
</body>
</html>
