glib-strings.html

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

<p>
Appends a formatted string onto the end of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>.
This function is similar to <a class="link" href="glib-Strings.html#g-string-printf"><code class="function">g_string_printf()</code></a> except 
that the text is appended to the <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>.</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>format</code></em>&#160;:</span></p></td>
<td> the string format. See the <code class="function">printf()</code> documentation
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td> the parameters to insert into the format string
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3302993"></a><h3>
<a name="g-string-append"></a>g_string_append ()</h3>
<a class="indexterm" name="id3303006"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val);</pre>
<p>
Adds a string onto the end of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, expanding 
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>val</code></em>&#160;:</span></p></td>
<td> the string to append onto the end 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="id3303116"></a><h3>
<a name="g-string-append-c"></a>g_string_append_c ()</h3>
<a class="indexterm" name="id3303129"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_c                   (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
<p>
Adds a byte onto the end of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, expanding 
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>c</code></em>&#160;:</span></p></td>
<td> the byte to append onto the end 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="id3303238"></a><h3>
<a name="g-string-append-unichar"></a>g_string_append_unichar ()</h3>
<a class="indexterm" name="id3303252"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_unichar             (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         <a class="link" 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><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>wc</code></em>&#160;:</span></p></td>
<td> a Unicode character
</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="id3303348"></a><h3>
<a name="g-string-append-len"></a>g_string_append_len ()</h3>
<a class="indexterm" name="id3303362"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_len                 (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         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>
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>
<p>
Since this function does not stop at nul bytes, it is 
the caller's responsibility to ensure that <em class="parameter"><code>val</code></em> has at 
least <em class="parameter"><code>len</code></em> addressable 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>val</code></em>&#160;:</span></p></td>
<td> bytes to append
</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 use
</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="id3303530"></a><h3>
<a name="g-string-append-uri-escaped"></a>g_string_append_uri_escaped ()</h3>
<a class="indexterm" name="id3303546"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_append_uri_escaped         (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         const char *unescaped,
                                                         const char *reserved_chars_allowed,
                                                         <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> allow_utf8);</pre>
<p>
Appends <em class="parameter"><code>unescaped</code></em> to <em class="parameter"><code>string</code></em>, escaped any characters that
are reserved in URIs using URI-style escape sequences.</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>unescaped</code></em>&#160;:</span></p></td>
<td> a string
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>reserved_chars_allowed</code></em>&#160;:</span></p></td>
<td> a string of reserved characters allowed to be used
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>allow_utf8</code></em>&#160;:</span></p></td>
<td> set <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the escaped string may include UTF8 characters
</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.16
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3303717"></a><h3>
<a name="g-string-prepend"></a>g_string_prepend ()</h3>
<a class="indexterm" name="id3303729"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend                    (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val);</pre>
<p>
Adds a string on to the start of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, 
expanding 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>val</code></em>&#160;:</span></p></td>
<td> the string to prepend on the start 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="id3303839"></a><h3>
<a name="g-string-prepend-c"></a>g_string_prepend_c ()</h3>
<a class="indexterm" name="id3303852"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend_c                  (<a class="link" href="glib-Strings.html#GString">GString</a> *string,