glib-strings.html

glid编写实例

Removes <em class="parameter"><code>len</code></em> characters from a <a 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 href="glib-Strings.html#GString"><span class="type">GString</span></a> is shifted down to fill the gap.
</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 of the characters to remove.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></td>
<td>the number of characters to remove, or -1 to remove all
      following characters.
</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="id3149419"></a><h3>
<a name="g-string-truncate"></a>g_string_truncate ()</h3>
<a class="indexterm" name="id3149430"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_truncate               (<a href="glib-Strings.html#GString">GString</a> *string,
                                             <a 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> characters.
</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>len</code></em>&#160;:</span></td>
<td>the new size 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="id3149537"></a><h3>
<a name="g-string-set-size"></a>g_string_set_size ()</h3>
<a class="indexterm" name="id3149548"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_set_size               (<a href="glib-Strings.html#GString">GString</a> *string,
                                             <a href="glib-Basic-Types.html#gsize">gsize</a> len);</pre>
<p>
Sets the length of a <a 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>
<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>len</code></em>&#160;:</span></td>
<td> the new length
</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="id3149654"></a><h3>
<a name="g-string-free"></a>g_string_free ()</h3>
<a class="indexterm" name="id3149665"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gchar">gchar</a>*      g_string_free                   (<a href="glib-Strings.html#GString">GString</a> *string,
                                             <a href="glib-Basic-Types.html#gboolean">gboolean</a> free_segment);</pre>
<p>
Frees the memory allocated for the <a href="glib-Strings.html#GString"><span class="type">GString</span></a>.
If <em class="parameter"><code>free_segment</code></em> is <code class="literal">TRUE</code> it also frees the character data.
</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>free_segment</code></em>&#160;:</span></td>
<td>if <code class="literal">TRUE</code> the actual character data is freed as well.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the character data of <em class="parameter"><code>string</code></em> (i.e. <code class="literal">NULL</code> if <em class="parameter"><code>free_segment</code></em> is <code class="literal">TRUE</code>)


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3149803"></a><h3>
<a name="g-string-up"></a>g_string_up ()</h3>
<a class="indexterm" name="id3149813"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_up                     (<a href="glib-Strings.html#GString">GString</a> *string);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_string_up</code> is deprecated and should not be used in newly-written code. This function uses the locale-specific <code class="function">toupper()</code> function, 
which is almost never the right thing. Use <a href="glib-String-Utility-Functions.html#g-string-ascii-up"><code class="function">g_string_ascii_up()</code></a> or 
<a href="glib-Unicode-Manipulation.html#g-utf8-strup"><code class="function">g_utf8_strup()</code></a> instead.</p>
</div>
<p>
Converts a <a href="glib-Strings.html#GString"><span class="type">GString</span></a> to uppercase.</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"><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="id3149941"></a><h3>
<a name="g-string-down"></a>g_string_down ()</h3>
<a class="indexterm" name="id3149952"></a><pre class="programlisting"><a href="glib-Strings.html#GString">GString</a>*    g_string_down                   (<a href="glib-Strings.html#GString">GString</a> *string);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_string_down</code> is deprecated and should not be used in newly-written code. This function uses the locale-specific <code class="function">tolower()</code> function, 
which is almost never the right thing. Use <a href="glib-String-Utility-Functions.html#g-string-ascii-down"><code class="function">g_string_ascii_down()</code></a> or 
<a href="glib-Unicode-Manipulation.html#g-utf8-strdown"><code class="function">g_utf8_strdown()</code></a> instead.</p>
</div>
<p>
Converts a <a href="glib-Strings.html#GString"><span class="type">GString</span></a> to lowercase.</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"><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="id3150081"></a><h3>
<a name="g-string-hash"></a>g_string_hash ()</h3>
<a class="indexterm" name="id3150091"></a><pre class="programlisting"><a href="glib-Basic-Types.html#guint">guint</a>       g_string_hash                   (const <a href="glib-Strings.html#GString">GString</a> *str);</pre>
<p>
Creates a hash code for <em class="parameter"><code>str</code></em>; for use with <a href="glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></td>
<td>a string to hash.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>hash code for <em class="parameter"><code>str</code></em>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3150167"></a><h3>
<a name="g-string-equal"></a>g_string_equal ()</h3>
<a class="indexterm" name="id3150178"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gboolean">gboolean</a>    g_string_equal                  (const <a href="glib-Strings.html#GString">GString</a> *v,
                                             const <a href="glib-Strings.html#GString">GString</a> *v2);</pre>
<p>
Compares two strings for equality, returning <code class="literal">TRUE</code> if they are equal. 
For use with <a href="glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>v</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>v2</code></em>&#160;:</span></td>
<td>another <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>
<code class="literal">TRUE</code> if they strings are the same length and contain the same bytes.


</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
<td align="left"><a accesskey="p" href="glib-Hash-Tables.html"><b>&lt;&lt;&#160;Hash Tables</b></a></td>
<td align="right"><a accesskey="n" href="glib-String-Chunks.html"><b>String Chunks&#160;&gt;&gt;</b></a></td>
</tr></table>
</body>
</html>