glib-string-chunks.html

最新gtk中文资料集

<td><p><span class="term"><em class="parameter"><code>chunk</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
<td> the string to add
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a pointer to the copy of <em class="parameter"><code>string</code></em> within 
         the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3312790"></a><h3>
<a name="g-string-chunk-insert-const"></a>g_string_chunk_insert_const ()</h3>
<a class="indexterm" name="id3312804"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_string_chunk_insert_const         (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
<p>
Adds a copy of <em class="parameter"><code>string</code></em> to the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>, unless the same 
string has already been added to the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a> with 
<a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const"><code class="function">g_string_chunk_insert_const()</code></a>.
</p>
<p>
This function is useful if you need to copy a large number 
of strings but do not want to waste space storing duplicates. 
But you must remember that there may be several pointers to 
the same string, and so any changes made to the strings 
should be done very carefully.
</p>
<p>
Note that <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const"><code class="function">g_string_chunk_insert_const()</code></a> will not return a 
pointer to a string added with <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert"><code class="function">g_string_chunk_insert()</code></a>, even 
if they do match.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>chunk</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
<td> the string to add
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a pointer to the new or existing copy of <em class="parameter"><code>string</code></em> 
         within the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3312978"></a><h3>
<a name="g-string-chunk-insert-len"></a>g_string_chunk_insert_len ()</h3>
<a class="indexterm" name="id3312993"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_string_chunk_insert_len           (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
<p>
Adds a copy of the first <em class="parameter"><code>len</code></em> bytes of <em class="parameter"><code>string</code></em> to the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>. 
The copy is nul-terminated.
</p>
<p>
Since this function does not stop at nul bytes, it is the caller's
responsibility to ensure that <em class="parameter"><code>string</code></em> has at least <em class="parameter"><code>len</code></em> addressable 
bytes.
</p>
<p>
The characters in the returned string can be changed, if necessary, 
though you should not change anything after the end of the string.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>chunk</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
<td> bytes to insert
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td> number of bytes of <em class="parameter"><code>string</code></em> to insert, or -1 to insert a 
    nul-terminated string 
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a pointer to the copy of <em class="parameter"><code>string</code></em> within the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3313176"></a><h3>
<a name="g-string-chunk-clear"></a>g_string_chunk_clear ()</h3>
<a class="indexterm" name="id3313192"></a><pre class="programlisting">void                g_string_chunk_clear                (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk);</pre>
<p>
Frees all strings contained within the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>.
After calling <a class="link" href="glib-String-Chunks.html#g-string-chunk-clear"><code class="function">g_string_chunk_clear()</code></a> it is not safe to
access any of the strings which were contained within it.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>chunk</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3313278"></a><h3>
<a name="g-string-chunk-free"></a>g_string_chunk_free ()</h3>
<a class="indexterm" name="id3313292"></a><pre class="programlisting">void                g_string_chunk_free                 (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk);</pre>
<p>
Frees all memory allocated by the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>.
After calling <a class="link" href="glib-String-Chunks.html#g-string-chunk-free"><code class="function">g_string_chunk_free()</code></a> it is not safe to
access any of the strings which were contained within it.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>chunk</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a> 
</td>
</tr></tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3313371"></a><div class="refsect2" lang="en"><a name="id3313372"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id3313374"></a></div>
</div>
</div>
</body>
</html>