glib-strings.html

glid编写实例

<hr>
<div class="refsect2" lang="en">
<a name="id3147264"></a><h3>
<a name="g-string-sprintfa"></a>g_string_sprintfa</h3>
<a class="indexterm" name="id3147274"></a><pre class="programlisting">#define     g_string_sprintfa</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_string_sprintfa</code> is deprecated and should not be used in newly-written code. This function has been renamed to <a href="glib-Strings.html#g-string-append-printf"><code class="function">g_string_append_printf()</code></a>.</p>
</div>
<p>
Appends a formatted string onto the end of a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
This function is is similar to <a href="glib-Strings.html#g-string-sprintf"><code class="function">g_string_sprintf()</code></a> except that
the text is appended to the <a href="glib-Strings.html#GString"><span class="type">GString</span></a>. 
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3147342"></a><h3>
<a name="g-string-printf"></a>g_string_printf ()</h3>
<a class="indexterm" name="id3147352"></a><pre class="programlisting">void        g_string_printf                 (<a href="glib-Strings.html#GString">GString</a> *string,
                                             const <a href="glib-Basic-Types.html#gchar">gchar</a> *format,
                                             ...);</pre>
<p>
Writes a formatted string into a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
This is similar to the standard <code class="function"><code class="function">sprintf()</code></code> function,
except that the <a href="glib-Strings.html#GString"><span class="type">GString</span></a> buffer automatically expands to contain the results.
The previous contents of the <a href="glib-Strings.html#GString"><span class="type">GString</span></a> are destroyed.
</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>format</code></em>&#160;:</span></td>
<td>the string format. See the <code class="function"><code class="function">printf()</code></code>
documentation.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
<td>the parameters to insert into the format string.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3147500"></a><h3>
<a name="g-string-append-printf"></a>g_string_append_printf ()</h3>
<a class="indexterm" name="id3147511"></a><pre class="programlisting">void        g_string_append_printf          (<a href="glib-Strings.html#GString">GString</a> *string,
                                             const <a href="glib-Basic-Types.html#gchar">gchar</a> *format,
                                             ...);</pre>
<p>
Appends a formatted string onto the end of a <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
This function is is similar to <a href="glib-Strings.html#g-string-printf"><code class="function">g_string_printf()</code></a> except that
the text is appended to the <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
</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>format</code></em>&#160;:</span></td>
<td>the string format. See the <code class="function"><code class="function">printf()</code></code>
documentation.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></td>
<td>the parameters to insert into the format string.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3147642"></a><h3>
<a name="g-string-append"></a>g_string_append ()</h3>
<a class="indexterm" name="id3147652"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_append                 (<a href="glib-Strings.html#GString">GString</a> *string,
                                             const <a href="glib-Basic-Types.html#gchar">gchar</a> *val);</pre>
<p>
Adds a string onto the end of 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>val</code></em>&#160;:</span></td>
<td>the string to append onto the end 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="id3147763"></a><h3>
<a name="g-string-append-c"></a>g_string_append_c ()</h3>
<a class="indexterm" name="id3147774"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_append_c               (<a href="glib-Strings.html#GString">GString</a> *string,
                                             <a href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
<p>
Adds a character onto the end of 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>c</code></em>&#160;:</span></td>
<td>the character to append onto the end 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="id3147884"></a><h3>
<a name="g-string-append-unichar"></a>g_string_append_unichar ()</h3>
<a class="indexterm" name="id3147895"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_append_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 appends 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="id3147991"></a><h3>
<a name="g-string-append-len"></a>g_string_append_len ()</h3>
<a class="indexterm" name="id3148002"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_append_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>
Appends <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 append.
</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 use.
</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="id3148152"></a><h3>
<a name="g-string-prepend"></a>g_string_prepend ()</h3>
<a class="indexterm" name="id3148162"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_prepend                (<a href="glib-Strings.html#GString">GString</a> *string,
                                             const <a href="glib-Basic-Types.html#gchar">gchar</a> *val);</pre>
<p>
Adds a string on to the start of 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>val</code></em>&#160;:</span></td>
<td>the string 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="id3148273"></a><h3>
<a name="g-string-prepend-c"></a>g_string_prepend_c ()</h3>
<a class="indexterm" name="id3148284"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_prepend_c              (<a href="glib-Strings.html#GString">GString</a> *string,
                                             <a href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
<p>
Adds a character onto the start of 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>