glib-strings.html

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

                                                         <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> c);</pre>
<p>
Adds a byte onto 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>c</code></em>&#160;:</span></p></td>
<td> the byte to prepend on the start of the <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</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="id3303963"></a><h3>
<a name="g-string-prepend-unichar"></a>g_string_prepend_unichar ()</h3>
<a class="indexterm" name="id3303976"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend_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 prepends 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="id3304072"></a><h3>
<a name="g-string-prepend-len"></a>g_string_prepend_len ()</h3>
<a class="indexterm" name="id3304085"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_prepend_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>
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>
<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 prepend
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td> number of bytes in <em class="parameter"><code>val</code></em> to prepend
</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="id3304254"></a><h3>
<a name="g-string-insert"></a>g_string_insert ()</h3>
<a class="indexterm" name="id3304267"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> pos,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *val);</pre>
<p>
Inserts a copy of a string into 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>pos</code></em>&#160;:</span></p></td>
<td> the position to insert the copy of the string
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>val</code></em>&#160;:</span></p></td>
<td> the string 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="id3304393"></a><h3>
<a name="g-string-insert-c"></a>g_string_insert_c ()</h3>
<a class="indexterm" name="id3304406"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert_c                   (<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#gchar">gchar</a> c);</pre>
<p>
Inserts a byte into 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>pos</code></em>&#160;:</span></p></td>
<td> the position to insert the byte
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>c</code></em>&#160;:</span></p></td>
<td> the byte 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="id3304531"></a><h3>
<a name="g-string-insert-unichar"></a>g_string_insert_unichar ()</h3>
<a class="indexterm" name="id3304544"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert_unichar             (<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-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><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 insert character, or -1 to
      append at the end of the string
</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="id3304663"></a><h3>
<a name="g-string-insert-len"></a>g_string_insert_len ()</h3>
<a class="indexterm" name="id3304677"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_insert_len                 (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</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>
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>
<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>pos</code></em>&#160;:</span></p></td>
<td> position in <em class="parameter"><code>string</code></em> where insertion should 
      happen, or -1 for at the end
</td>
</tr>