<html> <head> <title>Global Functions in Namespace in Sourcefile strbuf.h</title> <link rel="stylesheet" type="text/css" href="../cpp.css"> </head> <body> <div id="adc-cppref"> <a name="_top_"> </a><table class="navimain" border="0" cellpadding="1" cellspacing="0"> <tr align="center" valign="top"> <td class="navimain"> <a href="../index.html">Overview</a> </td> <td class="navimain"> <a href="index.html">Namespace</a> </td> <td class="navimainnone"> Class </td> <td class="navimain"> <a href="../index-files/index-1.html">Index</a> </td> <td class="navimain"> <a href="../help.html">Help</a> </td> </tr> </table> <table class="navisub" cellpadding="0" cellspacing="3"></table> <hr> <div class="title"><h2>Global Functions in Global Namespace C++<br> in Sourcefile strbuf.h</h2> </div><hr> <dl class="member"> <dt class="member"><a name="rtl_stringbuffer_ensureCapacity-1764"> </a>rtl_stringbuffer_ensureCapacity</dt> <dd class="member"><dl> <dt class="simple">extern "C"<br> void <strong>rtl_stringbuffer_ensureCapacity</strong>(</dt> <dd><table class="param-table"> <tr> <td><a href="t-rtl_String.html">rtl_String</a> * * </td> <td> This,</td> </tr> <tr> <td><a href="t-sal_Int32.html">sal_Int32</a> *</td> <td>capacity,</td> </tr> <tr> <td><a href="t-sal_Int32.html">sal_Int32</a></td> <td>minimumCapacity );</td> </tr> </table> </dd> </dl> <br> </dd> <dd class="member"><table class="flag-table" border="1" cellspacing="0"> <tr> <td width="12%" class="flagname">virtual</td> <td width="12%" class="flagname">abstract</td> <td width="12%" class="flagname">const</td> <td width="12%" class="flagname">volatile</td> <td width="12%" class="flagname">template</td> <td width="12%" class="flagname">static</td> <td width="12%" class="flagname">inline</td> <td width="12%" class="flagname">C-linkage</td> </tr> <tr> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagyes">YES</td> </tr> </table> <br> </dd> <dd class="member"><dl> <dt>Summary</dt> <dd>Ensures that the capacity of the buffer is at least equal to the specified minimum. </dd> <dt>Description</dt> <dd>If the current capacity of this string buffer is less than the argument, then a new internal buffer is allocated with greater capacity. The new capacity is the larger of: <ul> <li>The <code>minimumCapacity</code> argument. <li>Twice the old capacity, plus <code>2</code>. </ul> If the <code>minimumCapacity</code> argument is nonpositive, this method takes no action and simply returns. </dd> <dt>Parameters</dt> <dd><table border="0" width="100%" cellpadding="3" cellspacing="0" class="expl-table"> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">capacity</td> <td><pre>in: old capicity, out: new capacity. </pre></td> </tr> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">minimumCapacity</td> <td><pre>the minimum desired capacity. </pre></td> </tr> </table> </dd> </dl> </dd> </dl> <hr> <dl class="member"> <dt class="member"><a name="rtl_stringbuffer_insert-1765"> </a>rtl_stringbuffer_insert</dt> <dd class="member"><dl> <dt class="simple">extern "C"<br> void <strong>rtl_stringbuffer_insert</strong>(</dt> <dd><table class="param-table"> <tr> <td><a href="t-rtl_String.html">rtl_String</a> * * </td> <td> This,</td> </tr> <tr> <td><a href="t-sal_Int32.html">sal_Int32</a> *</td> <td>capacity,</td> </tr> <tr> <td><a href="t-sal_Int32.html">sal_Int32</a></td> <td>offset,</td> </tr> <tr> <td>const <a href="t-sal_Char.html">sal_Char</a> *</td> <td>str,</td> </tr> <tr> <td><a href="t-sal_Int32.html">sal_Int32</a></td> <td>len );</td> </tr> </table> </dd> </dl> <br> </dd> <dd class="member"><table class="flag-table" border="1" cellspacing="0"> <tr> <td width="12%" class="flagname">virtual</td> <td width="12%" class="flagname">abstract</td> <td width="12%" class="flagname">const</td> <td width="12%" class="flagname">volatile</td> <td width="12%" class="flagname">template</td> <td width="12%" class="flagname">static</td> <td width="12%" class="flagname">inline</td> <td width="12%" class="flagname">C-linkage</td> </tr> <tr> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagyes">YES</td> </tr> </table> <br> </dd> <dd class="member"><dl> <dt>Summary</dt> <dd>Inserts the string representation of the <code>char</code> array argument into this string buffer. </dd> <dt>Description</dt> <dd>The characters of the array argument are inserted into the contents of this string buffer at the position indicated by <code>offset</code>. The length of this string buffer increases by the length of the argument. </dd> <dt>Parameters</dt> <dd><table border="0" width="100%" cellpadding="3" cellspacing="0" class="expl-table"> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">capacity</td> <td><pre>the capacity of the string buffer </pre></td> </tr> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">offset</td> <td><pre>the offset. </pre></td> </tr> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">ch</td> <td><pre>a character array. </pre></td> </tr> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">len</td> <td><pre>the number of characters to append. </pre></td> </tr> </table> </dd> <dt>Return</dt> <dd>this string buffer. </dd> </dl> </dd> </dl> <hr> <dl class="member"> <dt class="member"><a name="rtl_stringbuffer_newFromStr_WithLength-1762"> </a>rtl_stringbuffer_newFromStr_WithLength</dt> <dd class="member"><dl> <dt class="simple">extern "C"<br> void <strong>rtl_stringbuffer_newFromStr_WithLength</strong>(</dt> <dd><table class="param-table"> <tr> <td><a href="t-rtl_String.html">rtl_String</a> * * </td> <td> newStr,</td> </tr> <tr> <td>const <a href="t-sal_Char.html">sal_Char</a> *</td> <td>value,</td> </tr> <tr> <td><a href="t-sal_Int32.html">sal_Int32</a></td> <td>count );</td> </tr> </table> </dd> </dl> <br> </dd> <dd class="member"><table class="flag-table" border="1" cellspacing="0"> <tr> <td width="12%" class="flagname">virtual</td> <td width="12%" class="flagname">abstract</td> <td width="12%" class="flagname">const</td> <td width="12%" class="flagname">volatile</td> <td width="12%" class="flagname">template</td> <td width="12%" class="flagname">static</td> <td width="12%" class="flagname">inline</td> <td width="12%" class="flagname">C-linkage</td> </tr> <tr> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagyes">YES</td> </tr> </table> <br> </dd> <dd class="member"><dl> <dt>Summary</dt> <dd>Allocates a new <code>String</code> that contains characters from the character array argument. </dd> <dt>Description</dt> <dd>The <code>count</code> argument specifies the length of the array. The initial capacity of the string buffer is <code>16</code> plus the length of the string argument. </dd> <dt>Parameters</dt> <dd><table border="0" width="100%" cellpadding="3" cellspacing="0" class="expl-table"> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">newStr</td> <td><pre>out parameter, contains the new string. The reference count is 1. </pre></td> </tr> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">value</td> <td><pre>the initial value of the string. </pre></td> </tr> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">count</td> <td><pre>the length of value. </pre></td> </tr> </table> </dd> </dl> </dd> </dl> <hr> <dl class="member"> <dt class="member"><a name="rtl_stringbuffer_newFromStringBuffer-1763"> </a>rtl_stringbuffer_newFromStringBuffer</dt> <dd class="member"><dl> <dt class="simple">extern "C"<br> <a href="t-sal_Int32.html">sal_Int32</a> <strong>rtl_stringbuffer_newFromStringBuffer</strong>(</dt> <dd><table class="param-table"> <tr> <td><a href="t-rtl_String.html">rtl_String</a> * * </td> <td> newStr,</td> </tr> <tr> <td><a href="t-sal_Int32.html">sal_Int32</a></td> <td>capacity,</td> </tr> <tr> <td><a href="t-rtl_String.html">rtl_String</a> *</td> <td>olsStr );</td> </tr> </table> </dd> </dl> <br> </dd> <dd class="member"><table class="flag-table" border="1" cellspacing="0"> <tr> <td width="12%" class="flagname">virtual</td> <td width="12%" class="flagname">abstract</td> <td width="12%" class="flagname">const</td> <td width="12%" class="flagname">volatile</td> <td width="12%" class="flagname">template</td> <td width="12%" class="flagname">static</td> <td width="12%" class="flagname">inline</td> <td width="12%" class="flagname">C-linkage</td> </tr> <tr> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagno">NO</td> <td class="flagyes">YES</td> </tr> </table> <br> </dd> <dd class="member"><dl> <dt>Summary</dt> <dd>Allocates a new <code>String</code> that contains the same sequence of characters as the string argument. </dd> <dt>Description</dt> <dd>The initial capacity is the larger of: <ul> <li> The <code>bufferLen</code> argument. <li> The <code>length</code> of the string argument. </ul> </dd> <dt>Parameters</dt> <dd><table border="0" width="100%" cellpadding="3" cellspacing="0" class="expl-table"> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">newStr</td> <td><pre>out parameter, contains the new string. The reference count is 1. </pre></td> </tr> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">capacity</td> <td><pre>the initial len of the string buffer. </pre></td> </tr> <tr> <td width="15%" style="vertical-align:top; font-weight:bold">oldStr</td> <td><pre>the initial value of the string. </pre></td> </tr> </table> </dd> <dt>Return</dt> <dd>the new capacity of the string buffer </dd> </dl> </dd> </dl> <hr> <a href="#_top_" class="objchapter">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2008 Sun Microsystems, Inc.</p> </div> <!-- id="adc-cppref" --> </body> </html>