glib-strings.html

来自「最新gtk中文资料集」· HTML 代码 · 共 1,286 行 · 第 1/5 页

<tr>
<td><p><span class="term"><em class="parameter"><code>val</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>val</code></em> to insert
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <em class="parameter"><code>string</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3304886"></a><h3>
<a name="g-string-overwrite"></a>g_string_overwrite ()</h3>
<a class="indexterm" name="id3304901"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_overwrite                  (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> pos,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val);</pre>
<p>
Overwrites part of a string, lengthening it if necessary.</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>string</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pos</code></em>&#160;:</span></p></td>
<td> the position at which to start overwriting
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>val</code></em>&#160;:</span></p></td>
<td> the string that will overwrite the <em class="parameter"><code>string</code></em> starting at <em class="parameter"><code>pos</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <em class="parameter"><code>string</code></em>

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3305037"></a><h3>
<a name="g-string-overwrite-len"></a>g_string_overwrite_len ()</h3>
<a class="indexterm" name="id3305053"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_overwrite_len              (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> pos,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val,
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
<p>
Overwrites part of a string, lengthening it if necessary. 
This function will work with embedded nuls.</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>string</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pos</code></em>&#160;:</span></p></td>
<td> the position at which to start overwriting
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>val</code></em>&#160;:</span></p></td>
<td> the string that will overwrite the <em class="parameter"><code>string</code></em> starting at <em class="parameter"><code>pos</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td> the number of bytes to write from <em class="parameter"><code>val</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <em class="parameter"><code>string</code></em>

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3305218"></a><h3>
<a name="g-string-erase"></a>g_string_erase ()</h3>
<a class="indexterm" name="id3305230"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_erase                      (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> pos,
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
<p>
Removes <em class="parameter"><code>len</code></em> bytes from a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, starting at position <em class="parameter"><code>pos</code></em>.
The rest of the <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a> is shifted down to fill the gap.</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>string</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pos</code></em>&#160;:</span></p></td>
<td> the position of the content to remove
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td> the number of bytes to remove, or -1 to remove all
      following bytes
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <em class="parameter"><code>string</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3305376"></a><h3>
<a name="g-string-truncate"></a>g_string_truncate ()</h3>
<a class="indexterm" name="id3305389"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_truncate                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> len);</pre>
<p>
Cuts off the end of the GString, leaving the first <em class="parameter"><code>len</code></em> bytes.</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>string</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td> the new size of <em class="parameter"><code>string</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <em class="parameter"><code>string</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3305495"></a><h3>
<a name="g-string-set-size"></a>g_string_set_size ()</h3>
<a class="indexterm" name="id3305508"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_set_size                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> len);</pre>
<p>
Sets the length of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>. If the length is less than
the current length, the string will be truncated. If the
length is greater than the current length, the contents
of the newly added area are undefined. (However, as
always, string-&gt;str[string-&gt;len] will be a nul byte.)</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>string</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td> the new length
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <em class="parameter"><code>string</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3305614"></a><h3>
<a name="g-string-free"></a>g_string_free ()</h3>
<a class="indexterm" name="id3305627"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_string_free                       (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> free_segment);</pre>
<p>
Frees the memory allocated for the <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>.
If <em class="parameter"><code>free_segment</code></em> is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> it also frees the character data.</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>string</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>free_segment</code></em>&#160;:</span></p></td>
<td> if <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> the actual character data is freed as well
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the character data of <em class="parameter"><code>string</code></em> 
         (i.e. <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>free_segment</code></em> is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>)
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3305786"></a><h3>
<a name="g-string-up"></a>g_string_up ()</h3>
<a class="indexterm" name="id3305801"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_up