glib-strings.html

glid编写实例

<tr>
<td>
<span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></td>
<td>a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>c</code></em>&#160;:</span></td>
<td>the character to prepend on the start of the <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3148395"></a><h3>
<a name="g-string-prepend-unichar"></a>g_string_prepend_unichar ()</h3>
<a class="indexterm" name="id3148405"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_prepend_unichar        (<a href="glib-Strings.html#GString">GString</a> *string,
                                             <a href="glib-Unicode-Manipulation.html#gunichar">gunichar</a> wc);</pre>
<p>
Converts a Unicode character into UTF-8, and prepends it
to the string.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></td>
<td> a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>wc</code></em>&#160;:</span></td>
<td> a Unicode character.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <em class="parameter"><code>string</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3148501"></a><h3>
<a name="g-string-prepend-len"></a>g_string_prepend_len ()</h3>
<a class="indexterm" name="id3148511"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_prepend_len            (<a href="glib-Strings.html#GString">GString</a> *string,
                                             const <a href="glib-Basic-Types.html#gchar">gchar</a> *val,
                                             <a href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
<p>
Prepends <em class="parameter"><code>len</code></em> bytes of <em class="parameter"><code>val</code></em> to <em class="parameter"><code>string</code></em>. Because <em class="parameter"><code>len</code></em> is provided, 
<em class="parameter"><code>val</code></em> may contain embedded nuls and need not be nul-terminated.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></td>
<td>a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>val</code></em>&#160;:</span></td>
<td>bytes to prepend.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></td>
<td>number of bytes in <em class="parameter"><code>val</code></em> to prepend.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the <a href="glib-Strings.html#GString"><span class="type">GString</span></a> passed in.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3148662"></a><h3>
<a name="g-string-insert"></a>g_string_insert ()</h3>
<a class="indexterm" name="id3148673"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_insert                 (<a href="glib-Strings.html#GString">GString</a> *string,
                                             <a href="glib-Basic-Types.html#gssize">gssize</a> pos,
                                             const <a href="glib-Basic-Types.html#gchar">gchar</a> *val);</pre>
<p>
Inserts a copy of a string into a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>, expanding it if necessary.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></td>
<td>a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pos</code></em>&#160;:</span></td>
<td>the position to insert the copy of the string.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>val</code></em>&#160;:</span></td>
<td>the string to insert.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3148798"></a><h3>
<a name="g-string-insert-c"></a>g_string_insert_c ()</h3>
<a class="indexterm" name="id3148809"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_insert_c               (<a href="glib-Strings.html#GString">GString</a> *string,
                                             <a href="glib-Basic-Types.html#gssize">gssize</a> pos,
                                             <a href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
<p>
Inserts a character into a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>, expanding it if necessary.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></td>
<td>a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pos</code></em>&#160;:</span></td>
<td>the position to insert the character.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>c</code></em>&#160;:</span></td>
<td>the character to insert.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3148932"></a><h3>
<a name="g-string-insert-unichar"></a>g_string_insert_unichar ()</h3>
<a class="indexterm" name="id3148944"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_insert_unichar         (<a href="glib-Strings.html#GString">GString</a> *string,
                                             <a href="glib-Basic-Types.html#gssize">gssize</a> pos,
                                             <a href="glib-Unicode-Manipulation.html#gunichar">gunichar</a> wc);</pre>
<p>
Converts a Unicode character into UTF-8, and insert it
into the string at the given position.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></td>
<td> a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pos</code></em>&#160;:</span></td>
<td> the position at which to insert character, or -1 to
      append at the end of the string.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>wc</code></em>&#160;:</span></td>
<td> a Unicode character
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <em class="parameter"><code>string</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3149062"></a><h3>
<a name="g-string-insert-len"></a>g_string_insert_len ()</h3>
<a class="indexterm" name="id3149073"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_insert_len             (<a href="glib-Strings.html#GString">GString</a> *string,
                                             <a href="glib-Basic-Types.html#gssize">gssize</a> pos,
                                             const <a href="glib-Basic-Types.html#gchar">gchar</a> *val,
                                             <a href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
<p>
Inserts <em class="parameter"><code>len</code></em> bytes of <em class="parameter"><code>val</code></em> into <em class="parameter"><code>string</code></em> at <em class="parameter"><code>pos</code></em>.  Because <em class="parameter"><code>len</code></em> is provided, <em class="parameter"><code>val</code></em>
 may contain embedded nuls and need not be nul-terminated. If <em class="parameter"><code>pos</code></em> is -1, bytes are inserted at the end of the string.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></td>
<td>a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pos</code></em>&#160;:</span></td>
<td>position in <em class="parameter"><code>string</code></em> where insertion should happen, or -1 for at the end.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>val</code></em>&#160;:</span></td>
<td>bytes to insert.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></td>
<td>number of bytes of <em class="parameter"><code>val</code></em> to insert.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3149264"></a><h3>
<a name="g-string-erase"></a>g_string_erase ()</h3>
<a class="indexterm" name="id3149274"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_erase                  (<a href="glib-Strings.html#GString">GString</a> *string,
                                             <a href="glib-Basic-Types.html#gssize">gssize</a> pos,
                                             <a href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
<p>