<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>Crystal Space 1.2.1: csStringFast< LEN > Class Template Reference (Crystal Space 1.2.1 Public API Reference)</title>
<link href="tabs.css" rel="stylesheet" type="text/css">
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<table border="0" cellpadding="0" cellspacing="0" width="100%" class="head">
<tr height="59">
<td class="head" width="202" valign="bottom" style="padding-left:0;"><a href="http://www.crystalspace3d.org/"><img src="csblur.png" width="236" height="59" alt="CrystalSpace" border="0"></a></td>
<td class="head"><h2>Public API Reference</h2></td>
</tr>
<tr height="11">
<td colspan="2" class="headshadow" valign="top" style="padding-left:0;"><img src="csblurb.png" width="236" height="11" alt="" border="0"></td>
</tr>
</table>
<div class="content">
<!-- Generated by Doxygen 1.5.3 -->
<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 class="current"><a href="classes.html"><span>Classes</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>
<div class="tabs">
<ul>
<li><a href="classes.html"><span>Alphabetical List</span></a></li>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<h1>csStringFast< LEN > Class Template Reference</h1><!-- doxytag: class="csStringFast" --><!-- doxytag: inherits="csStringBase" -->Subclass of <a class="el" href="classcsStringBase.html" title="This is a string class with a range of useful operators and type-safe overloads.">csStringBase</a> that contains an internal buffer which is faster than the always dynamically allocated buffer of <a class="el" href="classcsStringBase.html" title="This is a string class with a range of useful operators and type-safe overloads.">csStringBase</a>.
<a href="#_details">More...</a>
<p>
<code>#include <<a class="el" href="csstring_8h-source.html">csutil/csstring.h</a>></code>
<p>
<div class="dynheader">
Inheritance diagram for csStringFast< LEN >:</div>
<div class="dynsection">
<p><center><img src="classcsStringFast__inherit__graph.png" border="0" usemap="#csStringFast_3_01LEN_01_4__inherit__map" alt="Inheritance graph"></center>
<map name="csStringFast_3_01LEN_01_4__inherit__map">
<area shape="rect" href="classcsString.html" title="Thin wrapper around csStringFast<> with its default buffer size." alt="" coords="48,161,120,188"><area shape="rect" href="classcsStringBase.html" title="This is a string class with a range of useful operators and type-safe overloads." alt="" coords="32,7,136,33"></map>
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
<p>
<a href="classcsStringFast-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#986a25783688b4f756ce3eb61bfd0eff">csStringFast</a> (unsigned char c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object from a single unsigned character. <a href="#986a25783688b4f756ce3eb61bfd0eff"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#45911ea190a2c9cd34c9f0805664c732">csStringFast</a> (char c)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object from a single signed character. <a href="#45911ea190a2c9cd34c9f0805664c732"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#a803194cde2163767e1fc759e8b64e19">csStringFast</a> (const char *src, size_t _length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object from a C string, given the length. <a href="#a803194cde2163767e1fc759e8b64e19"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#d30c371c29cea0ed3ca11a9602e535b2">csStringFast</a> (const char *src)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object from a null-terminated C string. <a href="#d30c371c29cea0ed3ca11a9602e535b2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#344681cb7223da83662a36bb086cf6ac">csStringFast</a> (const <a class="el" href="classcsStringFast.html">csStringFast</a> &copy)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy constructor. <a href="#344681cb7223da83662a36bb086cf6ac"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#5f8847107d95ed4f72848f04e47ea782">csStringFast</a> (const <a class="el" href="classcsStringBase.html">csStringBase</a> &copy)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy constructor. <a href="#5f8847107d95ed4f72848f04e47ea782"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#6660e56e4a281647cb879be10f78c6dc">csStringFast</a> (size_t Length)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object and reserve space for at least Length characters. <a href="#6660e56e4a281647cb879be10f78c6dc"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#0efac2e772032371959b71919471b1bf">csStringFast</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create an empty <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object. <a href="#0efac2e772032371959b71919471b1bf"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#1f79797cac8cafd7a82467708cdf320b">Detach</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Detach the low-level null-terminated C-string buffer from the <a class="el" href="classcsString.html" title="Thin wrapper around csStringFast<> with its default buffer size.">csString</a> object. <a href="#1f79797cac8cafd7a82467708cdf320b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#49a4f3f62534048aa947da39a8fee1d8">Free</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Free the memory allocated for the string. <a href="#49a4f3f62534048aa947da39a8fee1d8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#9b5ce3297ba258454ad684e55e2dab85">GetCapacity</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the current capacity, not including the space for the implicit null terminator. <a href="#9b5ce3297ba258454ad684e55e2dab85"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual char const * </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#ae377ba228b98ff910c5508f320c0d75">GetData</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a pointer to the null-terminated character array. <a href="#ae377ba228b98ff910c5508f320c0d75"></a><br></td></tr>
<tr><td class="memTemplParams" nowrap colspan="2">template<typename T> </td></tr>
<tr><td class="memTemplItemLeft" nowrap align="right" valign="top">const <a class="el" href="classcsStringFast.html">csStringFast</a> & </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#afa91b8e35516324c49ff2f748bd26ec">operator=</a> (T const &s)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Assign a formatted value to this string. <a href="#afa91b8e35516324c49ff2f748bd26ec"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classcsStringFast.html">csStringFast</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#7fd076b23661571a4fbccb29cb61dde3">operator=</a> (const <a class="el" href="classcsStringBase.html">csStringBase</a> &copy)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Assign a value to this string. <a href="#7fd076b23661571a4fbccb29cb61dde3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#ec6b8c96e0f739e6ce084669850ba71e">ShrinkBestFit</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set string buffer capacity to hold exactly the current content. <a href="#ec6b8c96e0f739e6ce084669850ba71e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#82bdd0d8ed724e628fef6d7c946d0beb">~csStringFast</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destroy the <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a>. <a href="#82bdd0d8ed724e628fef6d7c946d0beb"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#9f09165e1d98b11ea26b755cf5037a8a">GetDataMutable</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get a pointer to the null-terminated character array. <a href="#9f09165e1d98b11ea26b755cf5037a8a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#74c9c4fc52344b763af729fa9529d17e">SetCapacityInternal</a> (size_t NewSize, bool soft)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the buffer to hold NewSize bytes. <a href="#74c9c4fc52344b763af729fa9529d17e"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Protected Attributes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">char </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#d0b09dc3848920bee618d78956125072">minibuff</a> [LEN]</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Internal buffer; used when capacity fits within LEN bytes. <a href="#d0b09dc3848920bee618d78956125072"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classcsStringFast.html#4e781ace33d0f30409fbc4daf8475a51">miniused</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Amount of minibuff allocated by <a class="el" href="classcsStringFast.html#74c9c4fc52344b763af729fa9529d17e" title="Set the buffer to hold NewSize bytes.">SetCapacityInternal()</a>; not necessarily same as Size. <a href="#4e781ace33d0f30409fbc4daf8475a51"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
<h3>template<int LEN = 36><br>
class csStringFast< LEN ></h3>
Subclass of <a class="el" href="classcsStringBase.html" title="This is a string class with a range of useful operators and type-safe overloads.">csStringBase</a> that contains an internal buffer which is faster than the always dynamically allocated buffer of <a class="el" href="classcsStringBase.html" title="This is a string class with a range of useful operators and type-safe overloads.">csStringBase</a>.
<p>Definition at line <a class="el" href="csstring_8h-source.html#l00957">957</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="0efac2e772032371959b71919471b1bf"></a><!-- doxytag: member="csStringFast::csStringFast" ref="0efac2e772032371959b71919471b1bf" args="()" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::<a class="el" href="classcsStringFast.html">csStringFast</a> </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create an empty <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object.
<p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01003">1003</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
</div>
</div><p>
<a class="anchor" name="6660e56e4a281647cb879be10f78c6dc"></a><!-- doxytag: member="csStringFast::csStringFast" ref="6660e56e4a281647cb879be10f78c6dc" args="(size_t Length)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::<a class="el" href="classcsStringFast.html">csStringFast</a> </td>
<td>(</td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>Length</em> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object and reserve space for at least Length characters.
<p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01008">1008</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="classcsStringBase.html#c30b6e2a574b5b2ada978221fd61f619">csStringBase::SetCapacity()</a>.</p>
</div>
</div><p>
<a class="anchor" name="5f8847107d95ed4f72848f04e47ea782"></a><!-- doxytag: member="csStringFast::csStringFast" ref="5f8847107d95ed4f72848f04e47ea782" args="(const csStringBase &copy)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::<a class="el" href="classcsStringFast.html">csStringFast</a> </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classcsStringBase.html">csStringBase</a> & </td>
<td class="paramname"> <em>copy</em> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Copy constructor.
<p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01013">1013</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="classcsStringBase.html#9b78c60659ea1e5bea610d4d2eb29016">csStringBase::Append()</a>.</p>
</div>
</div><p>
<a class="anchor" name="344681cb7223da83662a36bb086cf6ac"></a><!-- doxytag: member="csStringFast::csStringFast" ref="344681cb7223da83662a36bb086cf6ac" args="(const csStringFast &copy)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::<a class="el" href="classcsStringFast.html">csStringFast</a> </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN > & </td>
<td class="paramname"> <em>copy</em> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Copy constructor.
<p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01018">1018</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="classcsStringBase.html#9b78c60659ea1e5bea610d4d2eb29016">csStringBase::Append()</a>.</p>
</div>
</div><p>
<a class="anchor" name="d30c371c29cea0ed3ca11a9602e535b2"></a><!-- doxytag: member="csStringFast::csStringFast" ref="d30c371c29cea0ed3ca11a9602e535b2" args="(const char *src)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::<a class="el" href="classcsStringFast.html">csStringFast</a> </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>src</em> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object from a null-terminated C string.
<p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01023">1023</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="classcsStringBase.html#9b78c60659ea1e5bea610d4d2eb29016">csStringBase::Append()</a>.</p>
</div>
</div><p>
<a class="anchor" name="a803194cde2163767e1fc759e8b64e19"></a><!-- doxytag: member="csStringFast::csStringFast" ref="a803194cde2163767e1fc759e8b64e19" args="(const char *src, size_t _length)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::<a class="el" href="classcsStringFast.html">csStringFast</a> </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>src</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>_length</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object from a C string, given the length.
<p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01028">1028</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="classcsStringBase.html#9b78c60659ea1e5bea610d4d2eb29016">csStringBase::Append()</a>.</p>
</div>
</div><p>
<a class="anchor" name="45911ea190a2c9cd34c9f0805664c732"></a><!-- doxytag: member="csStringFast::csStringFast" ref="45911ea190a2c9cd34c9f0805664c732" args="(char c)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::<a class="el" href="classcsStringFast.html">csStringFast</a> </td>
<td>(</td>
<td class="paramtype">char </td>
<td class="paramname"> <em>c</em> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object from a single signed character.
<p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01033">1033</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="classcsStringBase.html#9b78c60659ea1e5bea610d4d2eb29016">csStringBase::Append()</a>.</p>
</div>
</div><p>
<a class="anchor" name="986a25783688b4f756ce3eb61bfd0eff"></a><!-- doxytag: member="csStringFast::csStringFast" ref="986a25783688b4f756ce3eb61bfd0eff" args="(unsigned char c)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::<a class="el" href="classcsStringFast.html">csStringFast</a> </td>
<td>(</td>
<td class="paramtype">unsigned char </td>
<td class="paramname"> <em>c</em> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a> object from a single unsigned character.
<p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01036">1036</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="classcsStringBase.html#9b78c60659ea1e5bea610d4d2eb29016">csStringBase::Append()</a>.</p>
</div>
</div><p>
<a class="anchor" name="82bdd0d8ed724e628fef6d7c946d0beb"></a><!-- doxytag: member="csStringFast::~csStringFast" ref="82bdd0d8ed724e628fef6d7c946d0beb" args="()" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::~<a class="el" href="classcsStringFast.html">csStringFast</a> </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [inline, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Destroy the <a class="el" href="classcsStringFast.html" title="Subclass of csStringBase that contains an internal buffer which is faster than the...">csStringFast</a>.
<p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01039">1039</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="1f79797cac8cafd7a82467708cdf320b"></a><!-- doxytag: member="csStringFast::Detach" ref="1f79797cac8cafd7a82467708cdf320b" args="()" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname">virtual char* <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::Detach </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [inline, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Detach the low-level null-terminated C-string buffer from the <a class="el" href="classcsString.html" title="Thin wrapper around csStringFast<> with its default buffer size.">csString</a> object.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The low-level null-terminated C-string buffer, or zero if this string represents a null-pointer. See the class description for a discussion about how and when the string will represent a null-pointer. </dd></dl>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>The caller of this function becomes the owner of the returned string buffer and is responsible for destroying it via `delete[]' when no longer needed. </dd></dl>
<p>Reimplemented from <a class="el" href="classcsStringBase.html#3fb2adf9b28acc7d2a69956187147243">csStringBase</a>.</p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01081">1081</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="cssysdef_8h.html#c380bd47888ecfe73e7b7a40b6f827a1">CS_ASSERT</a>, <a class="el" href="group__util.html#gc3a6e34ea28a22fdeda8802c872ce2d0">csStrNew()</a>, <a class="el" href="csstring_8h-source.html#l00062">csStringBase::Data</a>, <a class="el" href="csstring_8h-source.html#l00931">csStringBase::Detach()</a>, <a class="el" href="csstring_8h-source.html#l00066">csStringBase::MaxSize</a>, <a class="el" href="csstring_8h-source.html#l00961">csStringFast< LEN >::minibuff</a>, <a class="el" href="csstring_8h-source.html#l00970">csStringFast< LEN >::miniused</a>, and <a class="el" href="csstring_8h-source.html#l00064">csStringBase::Size</a>.</p>
</div>
</div><p>
<a class="anchor" name="49a4f3f62534048aa947da39a8fee1d8"></a><!-- doxytag: member="csStringFast::Free" ref="49a4f3f62534048aa947da39a8fee1d8" args="()" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname">virtual void <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::Free </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [inline, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Free the memory allocated for the string.
<p>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Following a call to this method, invocations of <a class="el" href="classcsStringFast.html#ae377ba228b98ff910c5508f320c0d75" title="Get a pointer to the null-terminated character array.">GetData()</a> and 'operator char const*' will return a null pointer (until some new content is added to the string). </dd></dl>
<p>Reimplemented from <a class="el" href="classcsStringBase.html#fa5e7cc27c97e4c970c19f1172117f6a">csStringBase</a>.</p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01079">1079</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="classcsStringBase.html#fa5e7cc27c97e4c970c19f1172117f6a">csStringBase::Free()</a>, and <a class="el" href="csstring_8h-source.html#l00970">csStringFast< LEN >::miniused</a>.</p>
</div>
</div><p>
<a class="anchor" name="9b5ce3297ba258454ad684e55e2dab85"></a><!-- doxytag: member="csStringFast::GetCapacity" ref="9b5ce3297ba258454ad684e55e2dab85" args="() const " -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname">virtual size_t <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::GetCapacity </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const<code> [inline, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Return the current capacity, not including the space for the implicit null terminator.
<p>
<p>Reimplemented from <a class="el" href="classcsStringBase.html#468fdc4e909ff172cd0f8fd5fb2c5cbc">csStringBase</a>.</p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01052">1052</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="csstring_8h-source.html#l00062">csStringBase::Data</a>, <a class="el" href="csstring_8h-source.html#l00117">csStringBase::GetCapacity()</a>, and <a class="el" href="csstring_8h-source.html#l00970">csStringFast< LEN >::miniused</a>.</p>
</div>
</div><p>
<a class="anchor" name="ae377ba228b98ff910c5508f320c0d75"></a><!-- doxytag: member="csStringFast::GetData" ref="ae377ba228b98ff910c5508f320c0d75" args="() const " -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname">virtual char const* <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::GetData </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const<code> [inline, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get a pointer to the null-terminated character array.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A C-string pointer to the null-terminated character array; or zero if the string represents a null-pointer. </dd></dl>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>See the class description for a discussion about how and when the string will represent a null-pointer. </dd></dl>
<p>Reimplemented from <a class="el" href="classcsStringBase.html#ef60d7152db4203e977d7a315e877183">csStringBase</a>.</p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01049">1049</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="csstring_8h-source.html#l00062">csStringBase::Data</a>, <a class="el" href="csstring_8h-source.html#l00961">csStringFast< LEN >::minibuff</a>, and <a class="el" href="csstring_8h-source.html#l00970">csStringFast< LEN >::miniused</a>.</p>
<p>Referenced by <a class="el" href="debugimagewriter_8h-source.html#l00061">csDebugImageWriter::DebugImageWrite()</a>, <a class="el" href="documenthelper_8h-source.html#l00317">CS::DocSystem::NodeAttributeRegexpTest::operator()()</a>, <a class="el" href="documenthelper_8h-source.html#l00291">CS::DocSystem::NodeAttributeValueTest::operator()()</a>, <a class="el" href="documenthelper_8h-source.html#l00241">CS::DocSystem::NodeAttributeCompare::operator()()</a>, and <a class="el" href="identstrings_8h-source.html#l00052">csIdentStrings::StringForIdent()</a>.</p>
</div>
</div><p>
<a class="anchor" name="9f09165e1d98b11ea26b755cf5037a8a"></a><!-- doxytag: member="csStringFast::GetDataMutable" ref="9f09165e1d98b11ea26b755cf5037a8a" args="()" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname">virtual char* <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::GetDataMutable </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [inline, protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get a pointer to the null-terminated character array.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A C-string pointer to the null-terminated character array; or zero if the string represents a null-pointer. </dd></dl>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>See the class description for a discussion about how and when the string will represent a null-pointer. </dd></dl>
<dl class="warning" compact><dt><b>Warning:</b></dt><dd>This returns a non-const pointer, so use this function with care. Call this only when you need to modify the string content. External clients are never allowed to directly modify the internal string buffer, which is why this function is not public. </dd></dl>
<p>Reimplemented from <a class="el" href="classcsStringBase.html#e85c1436f9f3a1edab265cbe760a9602">csStringBase</a>.</p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l00996">996</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="csstring_8h-source.html#l00062">csStringBase::Data</a>, <a class="el" href="csstring_8h-source.html#l00961">csStringFast< LEN >::minibuff</a>, and <a class="el" href="csstring_8h-source.html#l00970">csStringFast< LEN >::miniused</a>.</p>
</div>
</div><p>
<a class="anchor" name="afa91b8e35516324c49ff2f748bd26ec"></a><!-- doxytag: member="csStringFast::operator=" ref="afa91b8e35516324c49ff2f748bd26ec" args="(T const &s)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<div class="memtemplate">
template<typename T> </div>
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classcsStringFast.html">csStringFast</a>& <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::operator= </td>
<td>(</td>
<td class="paramtype">T const & </td>
<td class="paramname"> <em>s</em> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Assign a formatted value to this string.
<p>
<p>Reimplemented from <a class="el" href="classcsStringBase.html#58d4dacb4750781420975958f7148f69">csStringBase</a>.</p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01047">1047</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="classcsStringBase.html#6bb4fbecd065935ea4c6e0d9420a4b3f">csStringBase::Replace()</a>.</p>
</div>
</div><p>
<a class="anchor" name="7fd076b23661571a4fbccb29cb61dde3"></a><!-- doxytag: member="csStringFast::operator=" ref="7fd076b23661571a4fbccb29cb61dde3" args="(const csStringBase &copy)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classcsStringFast.html">csStringFast</a>& <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::operator= </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classcsStringBase.html">csStringBase</a> & </td>
<td class="paramname"> <em>copy</em> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Assign a value to this string.
<p>
<p>Reimplemented from <a class="el" href="classcsStringBase.html#bc902c60277c3939005049886f739478">csStringBase</a>.</p>
<p>Reimplemented in <a class="el" href="classcsString.html#a39053d32060564e963c094c9daa2f05">csString</a>.</p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01042">1042</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="classcsStringBase.html#6bb4fbecd065935ea4c6e0d9420a4b3f">csStringBase::Replace()</a>.</p>
</div>
</div><p>
<a class="anchor" name="74c9c4fc52344b763af729fa9529d17e"></a><!-- doxytag: member="csStringFast::SetCapacityInternal" ref="74c9c4fc52344b763af729fa9529d17e" args="(size_t NewSize, bool soft)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname">virtual void <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::SetCapacityInternal </td>
<td>(</td>
<td class="paramtype">size_t </td>
<td class="paramname"> <em>NewSize</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>soft</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [inline, protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the buffer to hold NewSize bytes.
<p>
If <em>soft</em> is true it means the buffer can be rounded up to reduce the number of allocations needed.
<p>Reimplemented from <a class="el" href="classcsStringBase.html#62840bf377294ec1d889857dadea6bf4">csStringBase</a>.</p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l00972">972</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="classcsStringBase.html#5bda81678e09cfaf998f8f6881111758">csStringBase::ComputeNewSize()</a>, <a class="el" href="cssysdef_8h.html#c380bd47888ecfe73e7b7a40b6f827a1">CS_ASSERT</a>, <a class="el" href="csstring_8h-source.html#l00062">csStringBase::Data</a>, <a class="el" href="csstring_8h-source.html#l00066">csStringBase::MaxSize</a>, <a class="el" href="csstring_8h-source.html#l00961">csStringFast< LEN >::minibuff</a>, <a class="el" href="csstring_8h-source.html#l00970">csStringFast< LEN >::miniused</a>, <a class="el" href="classcsStringBase.html#62840bf377294ec1d889857dadea6bf4">csStringBase::SetCapacityInternal()</a>, and <a class="el" href="csstring_8h-source.html#l00064">csStringBase::Size</a>.</p>
</div>
</div><p>
<a class="anchor" name="ec6b8c96e0f739e6ce084669850ba71e"></a><!-- doxytag: member="csStringFast::ShrinkBestFit" ref="ec6b8c96e0f739e6ce084669850ba71e" args="()" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname">virtual void <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::ShrinkBestFit </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [inline, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set string buffer capacity to hold exactly the current content.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Reference to itself. </dd></dl>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>If the string length is greater than zero, then the buffer's capacity will be adjusted to exactly that size. If the string length is zero, then this is equivalent to an invocation of <a class="el" href="classcsStringFast.html#49a4f3f62534048aa947da39a8fee1d8" title="Free the memory allocated for the string.">Free()</a>, which means that <a class="el" href="classcsStringFast.html#ae377ba228b98ff910c5508f320c0d75" title="Get a pointer to the null-terminated character array.">GetData()</a> and 'operator char const*' will return a null pointer after reclamation. </dd></dl>
<p>Reimplemented from <a class="el" href="classcsStringBase.html#516a2096e7ebf2a5c4d9b8a35bda2527">csStringBase</a>.</p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l01055">1055</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>References <a class="el" href="csstring_8h-source.html#l00062">csStringBase::Data</a>, <a class="el" href="classcsStringBase.html#fa5e7cc27c97e4c970c19f1172117f6a">csStringBase::Free()</a>, <a class="el" href="csstring_8h-source.html#l00961">csStringFast< LEN >::minibuff</a>, <a class="el" href="csstring_8h-source.html#l00970">csStringFast< LEN >::miniused</a>, <a class="el" href="classcsStringBase.html#516a2096e7ebf2a5c4d9b8a35bda2527">csStringBase::ShrinkBestFit()</a>, and <a class="el" href="csstring_8h-source.html#l00064">csStringBase::Size</a>.</p>
</div>
</div><p>
<hr><h2>Member Data Documentation</h2>
<a class="anchor" name="d0b09dc3848920bee618d78956125072"></a><!-- doxytag: member="csStringFast::minibuff" ref="d0b09dc3848920bee618d78956125072" args="[LEN]" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname">char <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::<a class="el" href="classcsStringFast.html#d0b09dc3848920bee618d78956125072">minibuff</a>[LEN]<code> [protected]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Internal buffer; used when capacity fits within LEN bytes.
<p>
<p>Definition at line <a class="el" href="csstring_8h-source.html#l00961">961</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>Referenced by <a class="el" href="csstring_8h-source.html#l01081">csStringFast< LEN >::Detach()</a>, <a class="el" href="csstring_8h-source.html#l01049">csStringFast< LEN >::GetData()</a>, <a class="el" href="csstring_8h-source.html#l00996">csStringFast< LEN >::GetDataMutable()</a>, <a class="el" href="csstring_8h-source.html#l00972">csStringFast< LEN >::SetCapacityInternal()</a>, and <a class="el" href="csstring_8h-source.html#l01055">csStringFast< LEN >::ShrinkBestFit()</a>.</p>
</div>
</div><p>
<a class="anchor" name="4e781ace33d0f30409fbc4daf8475a51"></a><!-- doxytag: member="csStringFast::miniused" ref="4e781ace33d0f30409fbc4daf8475a51" args="" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<int LEN = 36> </div>
<table class="memname">
<tr>
<td class="memname">size_t <a class="el" href="classcsStringFast.html">csStringFast</a>< LEN >::<a class="el" href="classcsStringFast.html#4e781ace33d0f30409fbc4daf8475a51">miniused</a><code> [protected]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Amount of minibuff allocated by <a class="el" href="classcsStringFast.html#74c9c4fc52344b763af729fa9529d17e" title="Set the buffer to hold NewSize bytes.">SetCapacityInternal()</a>; not necessarily same as Size.
<p>
This is analogous to MaxSize in <a class="el" href="classcsStringBase.html" title="This is a string class with a range of useful operators and type-safe overloads.">csStringBase</a>. We need it to determine if minibuff was ever used in order to return NULL if not (to emulate the NULL returned by <a class="el" href="classcsStringBase.html" title="This is a string class with a range of useful operators and type-safe overloads.">csStringBase</a> when no buffer has been allocated). We also use minibuff to emulate <a class="el" href="classcsStringFast.html#9b5ce3297ba258454ad684e55e2dab85" title="Return the current capacity, not including the space for the implicit null terminator...">GetCapacity()</a>, which is a predicate of several memory management methods, such as <a class="el" href="classcsStringBase.html#abe72c5a5d01846e3b9460782dcf3aa0" title="If necessary, increase the buffer capacity enough to hold NewSize bytes.">ExpandIfNeeded()</a>.
<p>Definition at line <a class="el" href="csstring_8h-source.html#l00970">970</a> of file <a class="el" href="csstring_8h-source.html">csstring.h</a>.</p>
<p>Referenced by <a class="el" href="csstring_8h-source.html#l01081">csStringFast< LEN >::Detach()</a>, <a class="el" href="csstring_8h-source.html#l01079">csStringFast< LEN >::Free()</a>, <a class="el" href="csstring_8h-source.html#l01052">csStringFast< LEN >::GetCapacity()</a>, <a class="el" href="csstring_8h-source.html#l01049">csStringFast< LEN >::GetData()</a>, <a class="el" href="csstring_8h-source.html#l00996">csStringFast< LEN >::GetDataMutable()</a>, <a class="el" href="csstring_8h-source.html#l00972">csStringFast< LEN >::SetCapacityInternal()</a>, and <a class="el" href="csstring_8h-source.html#l01055">csStringFast< LEN >::ShrinkBestFit()</a>.</p>
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li>csutil/<a class="el" href="csstring_8h-source.html">csstring.h</a></ul>
<hr size="1"><address><small>Generated for Crystal Space 1.2.1 by
<a href="http://www.doxygen.org/index.html">doxygen</a> 1.5.3
</small></address> </div></body> </html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
bad97183153701b09df5fae1052b1c30
>
files
>
1075
