<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>Apache Portable Runtime Utility Library: DBD routines</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.4 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
</ul>
</div>
<h1>DBD routines<br>
<small>
[<a class="el" href="group___a_p_r___util.html">APR Utility Functions</a>]</small>
</h1><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g91778287e3cd1b8ef8719ca2655e2bc8"></a><!-- doxytag: member="APR_Util_DBD::apr_dbd_driver_t" ref="g91778287e3cd1b8ef8719ca2655e2bc8" args="" -->
typedef struct apr_dbd_driver_t </td><td class="memItemRight" valign="bottom"><b>apr_dbd_driver_t</b></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g4738c1f6340184987fc7806522c18ab8"></a><!-- doxytag: member="APR_Util_DBD::apr_dbd_t" ref="g4738c1f6340184987fc7806522c18ab8" args="" -->
typedef struct apr_dbd_t </td><td class="memItemRight" valign="bottom"><b>apr_dbd_t</b></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g92eb10d7ec8fdb3a39a7d6fdfffdf8fb"></a><!-- doxytag: member="APR_Util_DBD::apr_dbd_transaction_t" ref="g92eb10d7ec8fdb3a39a7d6fdfffdf8fb" args="" -->
typedef struct <br>
apr_dbd_transaction_t </td><td class="memItemRight" valign="bottom"><b>apr_dbd_transaction_t</b></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g6765891011818912e1b52fef773bfce6"></a><!-- doxytag: member="APR_Util_DBD::apr_dbd_results_t" ref="g6765891011818912e1b52fef773bfce6" args="" -->
typedef struct apr_dbd_results_t </td><td class="memItemRight" valign="bottom"><b>apr_dbd_results_t</b></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gb890e4650a1de51725142318825103a5"></a><!-- doxytag: member="APR_Util_DBD::apr_dbd_row_t" ref="gb890e4650a1de51725142318825103a5" args="" -->
typedef struct apr_dbd_row_t </td><td class="memItemRight" valign="bottom"><b>apr_dbd_row_t</b></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g1f1179c6480a2ee0134f2cb881106cd3"></a><!-- doxytag: member="APR_Util_DBD::apr_dbd_prepared_t" ref="g1f1179c6480a2ee0134f2cb881106cd3" args="" -->
typedef struct apr_dbd_prepared_t </td><td class="memItemRight" valign="bottom"><b>apr_dbd_prepared_t</b></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g7969f50d38bda792cbef72136300a574">apr_dbd_init</a> (apr_pool_t *pool)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g8ba85faccf7e8eea525812f8f2dfed25">apr_dbd_get_driver</a> (apr_pool_t *pool, const char *name, const apr_dbd_driver_t **driver)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#geff12b01f78ac78721acc4a0a318e673">apr_dbd_open</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, const char *params, apr_dbd_t **handle)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">apr_status_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g4abe00d844cd547cc69880fe14af4aca">apr_dbd_close</a> (const apr_dbd_driver_t *driver, apr_dbd_t *handle)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g7a14e0073a36bd97dd82baa5f20e874c">apr_dbd_name</a> (const apr_dbd_driver_t *driver)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#gb2a238e15942e66a2b92836c392d5334">apr_dbd_native_handle</a> (const apr_dbd_driver_t *driver, apr_dbd_t *handle)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#ge3fca3b3c05f835f9849668a338d82d1">apr_dbd_check_conn</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#gfecb22f98684f29e579fd73eb58b1e86">apr_dbd_set_dbname</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, const char *name)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g1c401df12087d3bf1f15a9b80a8f572d">apr_dbd_transaction_start</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, apr_dbd_transaction_t **trans)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g6f3a5d6b351cd05646c9399a64eafeb5">apr_dbd_transaction_end</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_transaction_t *trans)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g40dbb6bb3f3f171f3443d21f3594a66a">apr_dbd_query</a> (const apr_dbd_driver_t *driver, apr_dbd_t *handle, int *nrows, const char *statement)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g144d354a36140fade933c1ef72661004">apr_dbd_select</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, apr_dbd_results_t **res, const char *statement, int random)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g77d1bccedee2c61dc96de6852f3a7cc4">apr_dbd_num_cols</a> (const apr_dbd_driver_t *driver, apr_dbd_results_t *res)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g2c9f511aba325f8904e69158eacd3987">apr_dbd_num_tuples</a> (const apr_dbd_driver_t *driver, apr_dbd_results_t *res)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#gd4cdc5f4e8981b93f5a467a8c8a768f1">apr_dbd_get_row</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_results_t *res, apr_dbd_row_t **row, int rownum)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g1d6d3b38a0d677e3d65501074832a5b8">apr_dbd_get_entry</a> (const apr_dbd_driver_t *driver, apr_dbd_row_t *row, int col)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#gffa947c657862c2996707da339482287">apr_dbd_error</a> (const apr_dbd_driver_t *driver, apr_dbd_t *handle, int errnum)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#gb5806cd6535aaeafe8e9f79ef2cc90c9">apr_dbd_escape</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, const char *string, apr_dbd_t *handle)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#gcf21412447c4357c64d1e9200a0f5eec">apr_dbd_prepare</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, const char *query, const char *label, apr_dbd_prepared_t **statement)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g1c4b005abda896011ca414679edfe112">apr_dbd_pquery</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, int *nrows, apr_dbd_prepared_t *statement, int nargs, const char **args)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g9f9ee377c2d335f8f1a9bffe4bf7194f">apr_dbd_pselect</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, apr_dbd_results_t **res, apr_dbd_prepared_t *statement, int random, int nargs, const char **args)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#g52ad74205d0afa92098e546303b9ee4c">apr_dbd_pvquery</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, int *nrows, apr_dbd_prepared_t *statement,...)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___a_p_r___util___d_b_d.html#gfbd4dbbddfa76586f172ec0832d4fd37">apr_dbd_pvselect</a> (const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, apr_dbd_results_t **res, apr_dbd_prepared_t *statement, int random,...)</td></tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="ge3fca3b3c05f835f9849668a338d82d1"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_check_conn" ref="ge3fca3b3c05f835f9849668a338d82d1" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_check_conn </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
check_conn: check status of a database connection<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>- working pool </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the connection to check </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS or error </dd></dl>
</div>
</div><p>
<a class="anchor" name="g4abe00d844cd547cc69880fe14af4aca"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_close" ref="g4abe00d844cd547cc69880fe14af4aca" args="(const apr_dbd_driver_t *driver, apr_dbd_t *handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_dbd_close </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_close: close a connection to a backend<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- handle to close </td></tr>
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- driver struct. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS for success or error status </dd></dl>
</div>
</div><p>
<a class="anchor" name="gffa947c657862c2996707da339482287"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_error" ref="gffa947c657862c2996707da339482287" args="(const apr_dbd_driver_t *driver, apr_dbd_t *handle, int errnum)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* apr_dbd_error </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>errnum</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_error: get current error message (if any)<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the connection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>errnum</em> </td><td>- error code from operation that returned an error </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the database current error message, or message for errnum (implementation-dependent whether errnum is ignored) </dd></dl>
</div>
</div><p>
<a class="anchor" name="gb5806cd6535aaeafe8e9f79ef2cc90c9"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_escape" ref="gb5806cd6535aaeafe8e9f79ef2cc90c9" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, const char *string, apr_dbd_t *handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* apr_dbd_escape </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>string</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_escape: escape a string so it is safe for use in query/select<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>- pool to alloc the result from </td></tr>
<tr><td valign="top"></td><td valign="top"><em>string</em> </td><td>- the string to escape </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the connection </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the escaped, safe string </dd></dl>
</div>
</div><p>
<a class="anchor" name="g8ba85faccf7e8eea525812f8f2dfed25"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_get_driver" ref="g8ba85faccf7e8eea525812f8f2dfed25" args="(apr_pool_t *pool, const char *name, const apr_dbd_driver_t **driver)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_dbd_get_driver </td>
<td>(</td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const apr_dbd_driver_t ** </td>
<td class="paramname"> <em>driver</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_get_driver: get the driver struct for a name<p>
<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>- (process) pool to register cleanup </td></tr>
<tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>- driver name </td></tr>
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- pointer to driver struct. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS for success <p>
APR_ENOTIMPL for no driver (when DSO not enabled) <p>
APR_EDSOOPEN if DSO driver file can't be opened <p>
APR_ESYMNOTFOUND if the driver file doesn't contain a driver </dd></dl>
</div>
</div><p>
<a class="anchor" name="g1d6d3b38a0d677e3d65501074832a5b8"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_get_entry" ref="g1d6d3b38a0d677e3d65501074832a5b8" args="(const apr_dbd_driver_t *driver, apr_dbd_row_t *row, int col)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* apr_dbd_get_entry </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_row_t * </td>
<td class="paramname"> <em>row</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>col</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_get_entry: get an entry from a row<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>row</em> </td><td>- row pointer </td></tr>
<tr><td valign="top"></td><td valign="top"><em>col</em> </td><td>- entry number </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>value from the row, or NULL if col is out of bounds. </dd></dl>
</div>
</div><p>
<a class="anchor" name="gd4cdc5f4e8981b93f5a467a8c8a768f1"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_get_row" ref="gd4cdc5f4e8981b93f5a467a8c8a768f1" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_results_t *res, apr_dbd_row_t **row, int rownum)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_get_row </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_results_t * </td>
<td class="paramname"> <em>res</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_row_t ** </td>
<td class="paramname"> <em>row</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>rownum</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_get_row: get a row from a result set<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>- pool to allocate the row </td></tr>
<tr><td valign="top"></td><td valign="top"><em>res</em> </td><td>- result set pointer </td></tr>
<tr><td valign="top"></td><td valign="top"><em>row</em> </td><td>- pointer to row pointer. May point to NULL on entry </td></tr>
<tr><td valign="top"></td><td valign="top"><em>rownum</em> </td><td>- row number, or -1 for "next row". Ignored if random access is not supported. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success, -1 for rownum out of range or data finished </dd></dl>
</div>
</div><p>
<a class="anchor" name="g7969f50d38bda792cbef72136300a574"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_init" ref="g7969f50d38bda792cbef72136300a574" args="(apr_pool_t *pool)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_dbd_init </td>
<td>(</td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_init: perform once-only initialisation. Call once only.<p>
<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>- pool to register any shutdown cleanups, etc </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="g7a14e0073a36bd97dd82baa5f20e874c"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_name" ref="g7a14e0073a36bd97dd82baa5f20e874c" args="(const apr_dbd_driver_t *driver)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* apr_dbd_name </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_name: get the name of the driver<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>- name </dd></dl>
</div>
</div><p>
<a class="anchor" name="gb2a238e15942e66a2b92836c392d5334"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_native_handle" ref="gb2a238e15942e66a2b92836c392d5334" args="(const apr_dbd_driver_t *driver, apr_dbd_t *handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void* apr_dbd_native_handle </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_native_handle: get native database handle of the underlying db<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- apr_dbd handle </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>- native handle </dd></dl>
</div>
</div><p>
<a class="anchor" name="g77d1bccedee2c61dc96de6852f3a7cc4"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_num_cols" ref="g77d1bccedee2c61dc96de6852f3a7cc4" args="(const apr_dbd_driver_t *driver, apr_dbd_results_t *res)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_num_cols </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_results_t * </td>
<td class="paramname"> <em>res</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_num_cols: get the number of columns in a results set<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>res</em> </td><td>- result set. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>number of columns </dd></dl>
</div>
</div><p>
<a class="anchor" name="g2c9f511aba325f8904e69158eacd3987"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_num_tuples" ref="g2c9f511aba325f8904e69158eacd3987" args="(const apr_dbd_driver_t *driver, apr_dbd_results_t *res)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_num_tuples </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_results_t * </td>
<td class="paramname"> <em>res</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_num_tuples: get the number of rows in a results set of a synchronous select<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>res</em> </td><td>- result set. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>number of rows, or -1 if the results are asynchronous </dd></dl>
</div>
</div><p>
<a class="anchor" name="geff12b01f78ac78721acc4a0a318e673"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_open" ref="geff12b01f78ac78721acc4a0a318e673" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, const char *params, apr_dbd_t **handle)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">apr_status_t apr_dbd_open </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>params</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t ** </td>
<td class="paramname"> <em>handle</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_open: open a connection to a backend<p>
<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>- working pool </td></tr>
<tr><td valign="top"></td><td valign="top"><em>params</em> </td><td>- arguments to driver (implementation-dependent) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- pointer to handle to return </td></tr>
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- driver struct. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>APR_SUCCESS for success <p>
APR_EGENERAL if driver exists but connection failed </dd></dl>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>PostgreSQL: the params is passed directly to the PQconnectdb() function (check PostgreSQL documentation for more details on the syntax). <p>
SQLite2: the params is split on a colon, with the first part used as the filename and second part converted to an integer and used as file mode. <p>
SQLite3: the params is passed directly to the sqlite3_open() function as a filename to be opened (check SQLite3 documentation for more details). <p>
MySQL: the params can have "host", "port", "user", "pass", "dbname", "sock", "flags" "fldsz" and "group" keys, each followed by an equal sign and a value. Such key/value pairs can be delimited by space, CR, LF, tab, semicolon, vertical bar or comma. For now, "flags" can only recognise CLIENT_FOUND_ROWS (check MySQL manual for details). The value associated with "fldsz" determines maximum amount of memory (in bytes) for each of the fields in the result set of prepared statements. By default, this value is 1 MB. The value associated with "group" determines which group from configuration file to use (see MYSQL_READ_DEFAULT_GROUP option of mysql_options() in MySQL manual). </dd></dl>
</div>
</div><p>
<a class="anchor" name="g1c4b005abda896011ca414679edfe112"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_pquery" ref="g1c4b005abda896011ca414679edfe112" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, int *nrows, apr_dbd_prepared_t *statement, int nargs, const char **args)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_pquery </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>nrows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_prepared_t * </td>
<td class="paramname"> <em>statement</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nargs</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char ** </td>
<td class="paramname"> <em>args</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_pquery: query using a prepared statement + args<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>- working pool </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the connection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nrows</em> </td><td>- number of rows affected. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>statement</em> </td><td>- the prepared statement to execute </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nargs</em> </td><td>- number of args to prepared statement </td></tr>
<tr><td valign="top"></td><td valign="top"><em>args</em> </td><td>- args to prepared statement </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
</div>
</div><p>
<a class="anchor" name="gcf21412447c4357c64d1e9200a0f5eec"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_prepare" ref="gcf21412447c4357c64d1e9200a0f5eec" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, const char *query, const char *label, apr_dbd_prepared_t **statement)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_prepare </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>query</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>label</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_prepared_t ** </td>
<td class="paramname"> <em>statement</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_prepare: prepare a statement<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>- pool to alloc the result from </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the connection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>query</em> </td><td>- the SQL query </td></tr>
<tr><td valign="top"></td><td valign="top"><em>label</em> </td><td>- A label for the prepared statement. use NULL for temporary prepared statements (eg within a Request in httpd) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>statement</em> </td><td>- statement to prepare. May point to null on entry. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>To specify parameters of the prepared query, use s in place of database specific parameter syntax (e.g. for PostgreSQL, this would be $1, $2, for SQLite3 this would be ? etc.). For instance: "SELECT name FROM customers WHERE name=s" would be a query that this function understands. Some drivers may support different data types using printf-like format: for example d (e.g. PostgreSQL) or f for numeric data. </dd></dl>
</div>
</div><p>
<a class="anchor" name="g9f9ee377c2d335f8f1a9bffe4bf7194f"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_pselect" ref="g9f9ee377c2d335f8f1a9bffe4bf7194f" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, apr_dbd_results_t **res, apr_dbd_prepared_t *statement, int random, int nargs, const char **args)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_pselect </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_results_t ** </td>
<td class="paramname"> <em>res</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_prepared_t * </td>
<td class="paramname"> <em>statement</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>random</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>nargs</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char ** </td>
<td class="paramname"> <em>args</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_pselect: select using a prepared statement + args<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>- working pool </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the connection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>res</em> </td><td>- pointer to query results. May point to NULL on entry </td></tr>
<tr><td valign="top"></td><td valign="top"><em>statement</em> </td><td>- the prepared statement to execute </td></tr>
<tr><td valign="top"></td><td valign="top"><em>random</em> </td><td>- Whether to support random-access to results </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nargs</em> </td><td>- number of args to prepared statement </td></tr>
<tr><td valign="top"></td><td valign="top"><em>args</em> </td><td>- args to prepared statement </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
</div>
</div><p>
<a class="anchor" name="g52ad74205d0afa92098e546303b9ee4c"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_pvquery" ref="g52ad74205d0afa92098e546303b9ee4c" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, int *nrows, apr_dbd_prepared_t *statement,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_pvquery </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>nrows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_prepared_t * </td>
<td class="paramname"> <em>statement</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_pvquery: query using a prepared statement + args<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>- working pool </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the connection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nrows</em> </td><td>- number of rows affected. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>statement</em> </td><td>- the prepared statement to execute </td></tr>
<tr><td valign="top"></td><td valign="top"><em>...</em> </td><td>- varargs list </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
</div>
</div><p>
<a class="anchor" name="gfbd4dbbddfa76586f172ec0832d4fd37"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_pvselect" ref="gfbd4dbbddfa76586f172ec0832d4fd37" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, apr_dbd_results_t **res, apr_dbd_prepared_t *statement, int random,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_pvselect </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_results_t ** </td>
<td class="paramname"> <em>res</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_prepared_t * </td>
<td class="paramname"> <em>statement</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>random</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_pvselect: select using a prepared statement + args<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>- working pool </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the connection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>res</em> </td><td>- pointer to query results. May point to NULL on entry </td></tr>
<tr><td valign="top"></td><td valign="top"><em>statement</em> </td><td>- the prepared statement to execute </td></tr>
<tr><td valign="top"></td><td valign="top"><em>random</em> </td><td>- Whether to support random-access to results </td></tr>
<tr><td valign="top"></td><td valign="top"><em>...</em> </td><td>- varargs list </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
</div>
</div><p>
<a class="anchor" name="g40dbb6bb3f3f171f3443d21f3594a66a"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_query" ref="g40dbb6bb3f3f171f3443d21f3594a66a" args="(const apr_dbd_driver_t *driver, apr_dbd_t *handle, int *nrows, const char *statement)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_query </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int * </td>
<td class="paramname"> <em>nrows</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>statement</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_query: execute an SQL query that doesn't return a result set<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the connection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nrows</em> </td><td>- number of rows affected. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>statement</em> </td><td>- the SQL statement to execute </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
</div>
</div><p>
<a class="anchor" name="g144d354a36140fade933c1ef72661004"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_select" ref="g144d354a36140fade933c1ef72661004" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, apr_dbd_results_t **res, const char *statement, int random)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_select </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_results_t ** </td>
<td class="paramname"> <em>res</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>statement</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>random</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_select: execute an SQL query that returns a result set<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>- pool to allocate the result set </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the connection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>res</em> </td><td>- pointer to result set pointer. May point to NULL on entry </td></tr>
<tr><td valign="top"></td><td valign="top"><em>statement</em> </td><td>- the SQL statement to execute </td></tr>
<tr><td valign="top"></td><td valign="top"><em>random</em> </td><td>- 1 to support random access to results (seek any row); 0 to support only looping through results in order (async access - faster) </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
</div>
</div><p>
<a class="anchor" name="gfecb22f98684f29e579fd73eb58b1e86"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_set_dbname" ref="gfecb22f98684f29e579fd73eb58b1e86" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, const char *name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_set_dbname </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>name</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_set_dbname: select database name. May be a no-op if not supported.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>- working pool </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the connection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>- the database to select </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
</div>
</div><p>
<a class="anchor" name="g6f3a5d6b351cd05646c9399a64eafeb5"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_transaction_end" ref="g6f3a5d6b351cd05646c9399a64eafeb5" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_transaction_t *trans)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_transaction_end </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_transaction_t * </td>
<td class="paramname"> <em>trans</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_transaction_end: end a transaction (commit on success, rollback on error). May be a no-op.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the db connection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>trans</em> </td><td>- the transaction. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
</div>
</div><p>
<a class="anchor" name="g1c401df12087d3bf1f15a9b80a8f572d"></a><!-- doxytag: member="apr_dbd.h::apr_dbd_transaction_start" ref="g1c401df12087d3bf1f15a9b80a8f572d" args="(const apr_dbd_driver_t *driver, apr_pool_t *pool, apr_dbd_t *handle, apr_dbd_transaction_t **trans)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int apr_dbd_transaction_start </td>
<td>(</td>
<td class="paramtype">const apr_dbd_driver_t * </td>
<td class="paramname"> <em>driver</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t * </td>
<td class="paramname"> <em>pool</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_t * </td>
<td class="paramname"> <em>handle</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_dbd_transaction_t ** </td>
<td class="paramname"> <em>trans</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
apr_dbd_transaction_start: start a transaction. May be a no-op.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>driver</em> </td><td>- the driver </td></tr>
<tr><td valign="top"></td><td valign="top"><em>pool</em> </td><td>- a pool to use for error messages (if any). </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handle</em> </td><td>- the db connection </td></tr>
<tr><td valign="top"></td><td valign="top"><em>trans</em> </td><td>- ptr to a transaction. May be null on entry </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or error code </dd></dl>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>If any of the query/select calls during a transaction return non-zero status code, the transaction will inherit this code and any further query/select calls will fail immediately. </dd></dl>
</div>
</div><p>
<hr size="1"><address style="text-align: right;"><small>Generated on Thu Jan 24 02:22:55 2008 for Apache Portable Runtime Utility Library by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.4 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2008.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
bdcd72668be70f58bf0aa7c2102b0734
>
files
>
127
