<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>Apache Portable Runtime: String routines</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.3.9.1 -->
<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="annotated.html">Data Structures</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Data Fields</a> | <a class="qindex" href="globals.html">Globals</a> | <a class="qindex" href="pages.html">Related Pages</a></div>
<h1>String routines<br>
<small>
[<a class="el" href="group__APR.html">Apache Portability Runtime library</a>]</small>
</h1><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Modules</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">group </td><td class="memItemRight" valign="bottom"><a class="el" href="group__APR__Strings__Snprintf.html">snprintf implementations</a></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga0">apr_strnatcmp</a> (char const *a, char const *b)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga1">apr_strnatcasecmp</a> (char const *a, char const *b)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga2">apr_pstrdup</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, const char *s)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga3">apr_pstrmemdup</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, const char *s, apr_size_t n)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga4">apr_pstrndup</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, const char *s, apr_size_t n)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga5">apr_pmemdup</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, const void *m, apr_size_t n)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga6">apr_pstrcat</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p,...)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga7">apr_pstrcatv</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, const struct iovec *vec, apr_size_t nvec, apr_size_t *nbytes)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga8">apr_pvsprintf</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, const char *fmt, va_list ap)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga9">apr_psprintf</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, const char *fmt,...)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga10">apr_cpystrn</a> (char *dst, const char *src, apr_size_t dst_size)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga11">apr_collapse_spaces</a> (char *dest, const char *src)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__errno.html#ga0">apr_status_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga12">apr_tokenize_to_argv</a> (const char *arg_str, char ***argv_out, <a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *token_context)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga13">apr_strtok</a> (char *str, const char *sep, char **last)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga14">apr_itoa</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, int n)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga15">apr_ltoa</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, long n)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga16">apr_off_t_toa</a> (<a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> *p, apr_off_t n)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="group__apr__errno.html#ga0">apr_status_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga17">apr_strtoff</a> (apr_off_t *offset, const char *buf, char **end, int base)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">apr_int64_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga18">apr_strtoi64</a> (const char *buf, char **end, int base)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">apr_int64_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga19">apr_atoi64</a> (const char *buf)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__apr__strings.html#ga20">apr_strfsize</a> (apr_off_t size, char *buf)</td></tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="ga19" doxytag="apr_strings.h::apr_atoi64"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">apr_int64_t apr_atoi64 </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname1" valign="top" nowrap> <em>buf</em> </td>
<td class="md" valign="top"> ) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
parse a base-10 numeric string into a 64-bit numeric value. Equivalent to apr_strtoi64(buf, (char**)NULL, 10). <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buf</em> </td><td>The string to parse </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The numeric value of the string </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga11" doxytag="apr_strings.h::apr_collapse_spaces"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_collapse_spaces </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">char * </td>
<td class="mdname" nowrap> <em>dest</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>src</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Strip spaces from a string <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dest</em> </td><td>The destination string. It is okay to modify the string in place. Namely dest == src </td></tr>
<tr><td valign="top"></td><td valign="top"><em>src</em> </td><td>The string to rid the spaces from. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The destination string, dest. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga10" doxytag="apr_strings.h::apr_cpystrn"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_cpystrn </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">char * </td>
<td class="mdname" nowrap> <em>dst</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>src</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>apr_size_t </td>
<td class="mdname" nowrap> <em>dst_size</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Copy up to dst_size characters from src to dst; does not copy past a NUL terminator in src, but always terminates dst with a NUL regardless. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dst</em> </td><td>The destination string </td></tr>
<tr><td valign="top"></td><td valign="top"><em>src</em> </td><td>The source string </td></tr>
<tr><td valign="top"></td><td valign="top"><em>dst_size</em> </td><td>The space available in dst; dst always receives NUL termination, so if src is longer than dst_size, the actual number of characters copied is dst_size - 1. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>Pointer to the NUL terminator of the destination string, dst </dd></dl>
<dl compact><dt><b>Remarks:</b></dt><dd><pre>
Note the differences between this function and strncpy():
1) strncpy() doesn't always NUL terminate; <a class="el" href="group__apr__strings.html#ga10">apr_cpystrn()</a> does.
2) strncpy() pads the destination string with NULs, which is often
unnecessary; <a class="el" href="group__apr__strings.html#ga10">apr_cpystrn()</a> does not.
3) strncpy() returns a pointer to the beginning of the dst string;
<a class="el" href="group__apr__strings.html#ga10">apr_cpystrn()</a> returns a pointer to the NUL terminator of dst,
to allow a check for truncation.
</pre> </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga14" doxytag="apr_strings.h::apr_itoa"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_itoa </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>n</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
create a string representation of an int, allocated from a pool <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool from which to allocate </td></tr>
<tr><td valign="top"></td><td valign="top"><em>n</em> </td><td>The number to format </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The string representation of the number </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga15" doxytag="apr_strings.h::apr_ltoa"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_ltoa </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>long </td>
<td class="mdname" nowrap> <em>n</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
create a string representation of a long, allocated from a pool <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool from which to allocate </td></tr>
<tr><td valign="top"></td><td valign="top"><em>n</em> </td><td>The number to format </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The string representation of the number </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga16" doxytag="apr_strings.h::apr_off_t_toa"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_off_t_toa </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>apr_off_t </td>
<td class="mdname" nowrap> <em>n</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
create a string representation of an apr_off_t, allocated from a pool <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool from which to allocate </td></tr>
<tr><td valign="top"></td><td valign="top"><em>n</em> </td><td>The number to format </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The string representation of the number </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga5" doxytag="apr_strings.h::apr_pmemdup"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">void* apr_pmemdup </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const void * </td>
<td class="mdname" nowrap> <em>m</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>apr_size_t </td>
<td class="mdname" nowrap> <em>n</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Duplicate a block of memory.<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>p</em> </td><td>The pool to allocate from </td></tr>
<tr><td valign="top"></td><td valign="top"><em>m</em> </td><td>The memory to duplicate </td></tr>
<tr><td valign="top"></td><td valign="top"><em>n</em> </td><td>The number of bytes to duplicate </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The new block of memory </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga9" doxytag="apr_strings.h::apr_psprintf"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_psprintf </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>fmt</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap> </td>
<td class="mdname" nowrap> <em>...</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
printf-style style printing routine. The data is output to a string allocated from a pool <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool to allocate out of </td></tr>
<tr><td valign="top"></td><td valign="top"><em>fmt</em> </td><td>The format of the string </td></tr>
<tr><td valign="top"></td><td valign="top"><em>...</em> </td><td>The arguments to use while printing the data </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The new string </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga6" doxytag="apr_strings.h::apr_pstrcat"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_pstrcat </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap> </td>
<td class="mdname" nowrap> <em>...</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Concatenate multiple strings, allocating memory out a pool <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool to allocate out of </td></tr>
<tr><td valign="top"></td><td valign="top"><em>...</em> </td><td>The strings to concatenate. The final string must be NULL </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The new string </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga7" doxytag="apr_strings.h::apr_pstrcatv"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_pstrcatv </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const struct iovec * </td>
<td class="mdname" nowrap> <em>vec</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>apr_size_t </td>
<td class="mdname" nowrap> <em>nvec</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>apr_size_t * </td>
<td class="mdname" nowrap> <em>nbytes</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Concatenate multiple strings specified in a writev-style vector <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool from which to allocate </td></tr>
<tr><td valign="top"></td><td valign="top"><em>vec</em> </td><td>The strings to concatenate </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nvec</em> </td><td>The number of strings to concatenate </td></tr>
<tr><td valign="top"></td><td valign="top"><em>nbytes</em> </td><td>(output) strlen of new string (pass in NULL to omit) </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The new string </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga2" doxytag="apr_strings.h::apr_pstrdup"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_pstrdup </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>s</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
duplicate a string into memory allocated out of a pool <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool to allocate out of </td></tr>
<tr><td valign="top"></td><td valign="top"><em>s</em> </td><td>The string to duplicate </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The new string </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga3" doxytag="apr_strings.h::apr_pstrmemdup"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_pstrmemdup </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>s</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>apr_size_t </td>
<td class="mdname" nowrap> <em>n</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Create a null-terminated string by making a copy of a sequence of characters and appending a null byte <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool to allocate out of </td></tr>
<tr><td valign="top"></td><td valign="top"><em>s</em> </td><td>The block of characters to duplicate </td></tr>
<tr><td valign="top"></td><td valign="top"><em>n</em> </td><td>The number of characters to duplicate </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The new string </dd></dl>
<dl compact><dt><b>Remarks:</b></dt><dd>This is a faster alternative to apr_pstrndup, for use when you know that the string being duplicated really has 'n' or more characters. If the string might contain fewer characters, use apr_pstrndup. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga4" doxytag="apr_strings.h::apr_pstrndup"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_pstrndup </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>s</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>apr_size_t </td>
<td class="mdname" nowrap> <em>n</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
duplicate the first n characters of a string into memory allocated out of a pool; the new string will be null-terminated <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool to allocate out of </td></tr>
<tr><td valign="top"></td><td valign="top"><em>s</em> </td><td>The string to duplicate </td></tr>
<tr><td valign="top"></td><td valign="top"><em>n</em> </td><td>The number of characters to duplicate </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The new string </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga8" doxytag="apr_strings.h::apr_pvsprintf"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_pvsprintf </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>p</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>fmt</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>va_list </td>
<td class="mdname" nowrap> <em>ap</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
printf-style style printing routine. The data is output to a string allocated from a pool <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>p</em> </td><td>The pool to allocate out of </td></tr>
<tr><td valign="top"></td><td valign="top"><em>fmt</em> </td><td>The format of the string </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ap</em> </td><td>The arguments to use while printing the data </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The new string </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga20" doxytag="apr_strings.h::apr_strfsize"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_strfsize </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">apr_off_t </td>
<td class="mdname" nowrap> <em>size</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>char * </td>
<td class="mdname" nowrap> <em>buf</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Format a binary size (magnitiudes are 2^10 rather than 10^3) from an apr_off_t, as bytes, K, M, T, etc, to a four character compacted human readable string. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>size</em> </td><td>The size to format </td></tr>
<tr><td valign="top"></td><td valign="top"><em>buf</em> </td><td>The 5 byte text buffer (counting the trailing null) </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The buf passed to <a class="el" href="group__apr__strings.html#ga20">apr_strfsize()</a> </dd></dl>
<dl compact><dt><b>Remarks:</b></dt><dd>All negative sizes report ' - ', apr_strfsize only formats positive values. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga1" doxytag="apr_strings.h::apr_strnatcasecmp"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">int apr_strnatcasecmp </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">char const * </td>
<td class="mdname" nowrap> <em>a</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>char const * </td>
<td class="mdname" nowrap> <em>b</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Do a natural order comparison of two strings ignoring the case of the strings. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>a</em> </td><td>The first string to compare </td></tr>
<tr><td valign="top"></td><td valign="top"><em>b</em> </td><td>The second string to compare </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>Either <0, 0, or >0. If the first string is less than the second this returns <0, if they are equivalent it returns 0, and if the first string is greater than second string it retuns >0. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga0" doxytag="apr_strings.h::apr_strnatcmp"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">int apr_strnatcmp </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">char const * </td>
<td class="mdname" nowrap> <em>a</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>char const * </td>
<td class="mdname" nowrap> <em>b</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Do a natural order comparison of two strings. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>a</em> </td><td>The first string to compare </td></tr>
<tr><td valign="top"></td><td valign="top"><em>b</em> </td><td>The second string to compare </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>Either <0, 0, or >0. If the first string is less than the second this returns <0, if they are equivalent it returns 0, and if the first string is greater than second string it retuns >0. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga17" doxytag="apr_strings.h::apr_strtoff"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__errno.html#ga0">apr_status_t</a> apr_strtoff </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">apr_off_t * </td>
<td class="mdname" nowrap> <em>offset</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>buf</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>char ** </td>
<td class="mdname" nowrap> <em>end</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>base</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Convert a numeric string into an apr_off_t numeric value. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>offset</em> </td><td>The value of the parsed string. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>buf</em> </td><td>The string to parse. It may contain optional whitespace, followed by an optional '+' (positive, default) or '-' (negative) character, followed by an optional '0x' prefix if base is 0 or 16, followed by numeric digits appropriate for base. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>end</em> </td><td>A pointer to the end of the valid character in buf. If not NULL, it is set to the first invalid character in buf. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>base</em> </td><td>A numeric base in the range between 2 and 36 inclusive, or 0. If base is zero, buf will be treated as base ten unless its digits are prefixed with '0x', in which case it will be treated as base 16. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a class="anchor" name="ga18" doxytag="apr_strings.h::apr_strtoi64"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">apr_int64_t apr_strtoi64 </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname" nowrap> <em>buf</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>char ** </td>
<td class="mdname" nowrap> <em>end</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>int </td>
<td class="mdname" nowrap> <em>base</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
parse a numeric string into a 64-bit numeric value <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buf</em> </td><td>The string to parse. It may contain optional whitespace, followed by an optional '+' (positive, default) or '-' (negative) character, followed by an optional '0x' prefix if base is 0 or 16, followed by numeric digits appropriate for base. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>end</em> </td><td>A pointer to the end of the valid character in buf. If not NULL, it is set to the first invalid character in buf. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>base</em> </td><td>A numeric base in the range between 2 and 36 inclusive, or 0. If base is zero, buf will be treated as base ten unless its digits are prefixed with '0x', in which case it will be treated as base 16. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The numeric value of the string. On overflow, errno is set to ERANGE. </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga13" doxytag="apr_strings.h::apr_strtok"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top">char* apr_strtok </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">char * </td>
<td class="mdname" nowrap> <em>str</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>const char * </td>
<td class="mdname" nowrap> <em>sep</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>char ** </td>
<td class="mdname" nowrap> <em>last</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Split a string into separate null-terminated tokens. The tokens are delimited in the string by one or more characters from the sep argument. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>str</em> </td><td>The string to separate; this should be specified on the first call to <a class="el" href="group__apr__strings.html#ga13">apr_strtok()</a> for a given string, and NULL on subsequent calls. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>sep</em> </td><td>The set of delimiters </td></tr>
<tr><td valign="top"></td><td valign="top"><em>last</em> </td><td>Internal state saved by <a class="el" href="group__apr__strings.html#ga13">apr_strtok()</a> between calls. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The next token from the string </dd></dl>
</td>
</tr>
</table>
<a class="anchor" name="ga12" doxytag="apr_strings.h::apr_tokenize_to_argv"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"><a class="el" href="group__apr__errno.html#ga0">apr_status_t</a> apr_tokenize_to_argv </td>
<td class="md" valign="top">( </td>
<td class="md" nowrap valign="top">const char * </td>
<td class="mdname" nowrap> <em>arg_str</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap>char *** </td>
<td class="mdname" nowrap> <em>argv_out</em>, </td>
</tr>
<tr>
<td class="md" nowrap align="right"></td>
<td class="md"></td>
<td class="md" nowrap><a class="el" href="group__apr__pools.html#ga0">apr_pool_t</a> * </td>
<td class="mdname" nowrap> <em>token_context</em></td>
</tr>
<tr>
<td class="md"></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
<tr>
<td>
</td>
<td>
<p>
Convert the arguments to a program from one string to an array of strings terminated by a NULL pointer <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>arg_str</em> </td><td>The arguments to convert </td></tr>
<tr><td valign="top"></td><td valign="top"><em>argv_out</em> </td><td>Output location. This is a pointer to an array of strings. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>token_context</em> </td><td>Pool to use. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Sun Mar 20 19:52:28 2005 for Apache Portable Runtime by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.3.9.1 </small></address>
</body>
</html>
