glib-hash-tables.html

glid编写实例

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3140298"></a><h3>
<a name="g-hash-table-freeze"></a>g_hash_table_freeze()</h3>
<a class="indexterm" name="id3140309"></a><pre class="programlisting">#define     g_hash_table_freeze(hash_table)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_hash_table_freeze</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function is deprecated and will be removed in the next major
 release of GLib. It does nothing.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>hash_table</code></em>&#160;:</span></td>
<td>a <a href="glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3140364"></a><h3>
<a name="g-hash-table-thaw"></a>g_hash_table_thaw()</h3>
<a class="indexterm" name="id3140374"></a><pre class="programlisting">#define     g_hash_table_thaw(hash_table)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_hash_table_thaw</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function is deprecated and will be removed in the next major
 release of GLib. It does nothing.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>hash_table</code></em>&#160;:</span></td>
<td>a <a href="glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3140430"></a><h3>
<a name="g-hash-table-destroy"></a>g_hash_table_destroy ()</h3>
<a class="indexterm" name="id3140440"></a><pre class="programlisting">void        g_hash_table_destroy            (<a href="glib-Hash-Tables.html#GHashTable">GHashTable</a> *hash_table);</pre>
<p>
Destroys the <a href="glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>. If keys and/or values are dynamically 
allocated, you should either free them first or create the <a href="glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>
using <a href="glib-Hash-Tables.html#g-hash-table-new-full"><code class="function">g_hash_table_new_full()</code></a>. In the latter case the destroy functions 
you supplied will be called on all keys and values before destroying 
the <a href="glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>hash_table</code></em>&#160;:</span></td>
<td> a <a href="glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3140536"></a><h3>
<a name="g-direct-equal"></a>g_direct_equal ()</h3>
<a class="indexterm" name="id3140546"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gboolean">gboolean</a>    g_direct_equal                  (<a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> v,
                                             <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> v2);</pre>
<p>
Compares two <a href="glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> arguments and returns <code class="literal">TRUE</code> if they are equal.
It can be passed to <a href="glib-Hash-Tables.html#g-hash-table-new"><code class="function">g_hash_table_new()</code></a> as the <em class="parameter"><code>key_equal_func</code></em>
parameter, when using pointers as keys in a <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 key.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>v2</code></em>&#160;:</span></td>
<td>a key to compare with <em class="parameter"><code>v</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>
<code class="literal">TRUE</code> if the two keys match.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3140676"></a><h3>
<a name="g-direct-hash"></a>g_direct_hash ()</h3>
<a class="indexterm" name="id3140686"></a><pre class="programlisting"><a href="glib-Basic-Types.html#guint">guint</a>       g_direct_hash                   (<a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> v);</pre>
<p>
Converts a gpointer to a hash value.
It can be passed to <a href="glib-Hash-Tables.html#g-hash-table-new"><code class="function">g_hash_table_new()</code></a> as the <em class="parameter"><code>hash_func</code></em> parameter, when
using pointers as keys in a <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 gpointer key.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>a hash value corresponding to the key.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3140770"></a><h3>
<a name="g-int-equal"></a>g_int_equal ()</h3>
<a class="indexterm" name="id3140780"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gboolean">gboolean</a>    g_int_equal                     (<a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> v,
                                             <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> v2);</pre>
<p>
Compares the two <a href="glib-Basic-Types.html#gint"><span class="type">gint</span></a> values being pointed to and returns <code class="literal">TRUE</code> if they are
equal.
It can be passed to <a href="glib-Hash-Tables.html#g-hash-table-new"><code class="function">g_hash_table_new()</code></a> as the <em class="parameter"><code>key_equal_func</code></em>
parameter, when using pointers to integers as keys in a <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 pointer to a <a href="glib-Basic-Types.html#gint"><span class="type">gint</span></a> key.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>v2</code></em>&#160;:</span></td>
<td>a pointer to a <a href="glib-Basic-Types.html#gint"><span class="type">gint</span></a> key to compare with <em class="parameter"><code>v</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>
<code class="literal">TRUE</code> if the two keys match.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3140925"></a><h3>
<a name="g-int-hash"></a>g_int_hash ()</h3>
<a class="indexterm" name="id3140935"></a><pre class="programlisting"><a href="glib-Basic-Types.html#guint">guint</a>       g_int_hash                      (<a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> v);</pre>
<p>
Converts a pointer to a <a href="glib-Basic-Types.html#gint"><span class="type">gint</span></a> to a hash value.
It can be passed to <a href="glib-Hash-Tables.html#g-hash-table-new"><code class="function">g_hash_table_new()</code></a> as the <em class="parameter"><code>hash_func</code></em> parameter, when
using pointers to integers values as keys in a <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 pointer to a <a href="glib-Basic-Types.html#gint"><span class="type">gint</span></a> key.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>a hash value corresponding to the key.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3141035"></a><h3>
<a name="g-str-equal"></a>g_str_equal ()</h3>
<a class="indexterm" name="id3141045"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gboolean">gboolean</a>    g_str_equal                     (<a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> v,
                                             <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> v2);</pre>
<p>
Compares two strings and returns <code class="literal">TRUE</code> if they are equal.
It can be passed to <a href="glib-Hash-Tables.html#g-hash-table-new"><code class="function">g_hash_table_new()</code></a> as the <em class="parameter"><code>key_equal_func</code></em>
parameter, when using strings as keys in a <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 key.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>v2</code></em>&#160;:</span></td>
<td>a key to compare with <em class="parameter"><code>v</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>
<code class="literal">TRUE</code> if the two keys match.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3141166"></a><h3>
<a name="g-str-hash"></a>g_str_hash ()</h3>
<a class="indexterm" name="id3141177"></a><pre class="programlisting"><a href="glib-Basic-Types.html#guint">guint</a>       g_str_hash                      (<a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> v);</pre>
<p>
Converts a string to a hash value.
It can be passed to <a href="glib-Hash-Tables.html#g-hash-table-new"><code class="function">g_hash_table_new()</code></a> as the <em class="parameter"><code>hash_func</code></em> parameter, when
using strings as keys in a <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 string key.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>a hash value corresponding to the key.


</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-Trash-Stacks.html"><b>&lt;&lt;&#160;Trash Stacks</b></a></td>
<td align="right"><a accesskey="n" href="glib-Strings.html"><b>Strings&#160;&gt;&gt;</b></a></td>
</tr></table>
</body>
</html>