← Back to branch summary

~ubuntu-branches/ubuntu/trusty/glib2.0/trusty-proposed

« back to all changes in this revision

Viewing changes to docs/reference/glib/html/glib-Hash-Tables.html

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2014-03-04 13:08:00 UTC
  • mfrom: (1.63.34)
  • Revision ID: package-import@ubuntu.com-20140304130800-6f4fs4s8iri00blg
Tags: 2.39.91-0ubuntu1
* New upstream release 2.39.91
* revert-0001-Improve-GAsyncQueue-test-coverage.patch: Drop, fixed upstream.
* Re-enable test_timer_stop to gather more information about the failure.
* debian/libglib2.0-0.symbols: Update with new symbols in this release. 

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/glib/html/glib-Hash-Tables.html
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
16
16
<td width="100%" align="left" class="shortcuts">
17
 
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
18
 
                  <a href="#glib-Hash-Tables.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19
 
                  <a href="#glib-Hash-Tables.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
 
17
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
 
18
                  <a href="#glib-Hash-Tables.description" class="shortcut">Description</a></span>
20
19
</td>
21
20
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22
21
<td><a accesskey="u" href="glib-data-types.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
420
419
</table></div>
421
420
</div>
422
421
<div class="refsect1">
423
 
<a name="glib-Hash-Tables.object-hierarchy"></a><h2>Object Hierarchy</h2>
424
 
<pre class="screen">
425
 
</pre>
426
 
</div>
427
 
<div class="refsect1">
428
422
<a name="glib-Hash-Tables.includes"></a><h2>Includes</h2>
429
423
<pre class="synopsis">#include &lt;glib.h&gt;
430
424
</pre>
490
484
a similar fashion to <a class="link" href="glib-Hash-Tables.html#g-direct-equal" title="g_direct_equal ()"><code class="function">g_direct_equal()</code></a>, but without the overhead of
491
485
a function call.</p>
492
486
<div class="refsect3">
493
 
<a name="id-1.6.7.8.2.7"></a><h4>Parameters</h4>
 
487
<a name="id-1.6.7.7.2.7"></a><h4>Parameters</h4>
494
488
<div class="informaltable"><table width="100%" border="0">
495
489
<colgroup>
496
490
<col width="150px" class="parameters_name">
512
506
</table></div>
513
507
</div>
514
508
<div class="refsect3">
515
 
<a name="id-1.6.7.8.2.8"></a><h4>Returns</h4>
 
509
<a name="id-1.6.7.7.2.8"></a><h4>Returns</h4>
516
510
<p> a new <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a></p>
517
511
<p></p>
518
512
</div>
530
524
allocated for the key and value that get called when removing the
531
525
entry from the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>.</p>
532
526
<div class="refsect3">
533
 
<a name="id-1.6.7.8.3.5"></a><h4>Parameters</h4>
 
527
<a name="id-1.6.7.7.3.5"></a><h4>Parameters</h4>
534
528
<div class="informaltable"><table width="100%" border="0">
535
529
<colgroup>
536
530
<col width="150px" class="parameters_name">
566
560
</table></div>
567
561
</div>
568
562
<div class="refsect3">
569
 
<a name="id-1.6.7.8.3.6"></a><h4>Returns</h4>
 
563
<a name="id-1.6.7.7.3.6"></a><h4>Returns</h4>
570
564
<p> a new <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a></p>
571
565
<p></p>
572
566
</div>
602
596
remainder is taken modulo a somewhat predictable prime number.  There
603
597
must be an element of randomness that an attacker is unable to guess.</p>
604
598
<div class="refsect3">
605
 
<a name="id-1.6.7.8.4.10"></a><h4>Parameters</h4>
 
599
<a name="id-1.6.7.7.4.10"></a><h4>Parameters</h4>
606
600
<div class="informaltable"><table width="100%" border="0">
607
601
<colgroup>
608
602
<col width="150px" class="parameters_name">
617
611
</table></div>
618
612
</div>
619
613
<div class="refsect3">
620
 
<a name="id-1.6.7.8.4.11"></a><h4>Returns</h4>
 
614
<a name="id-1.6.7.7.4.11"></a><h4>Returns</h4>
621
615
<p> the hash value corresponding to the key</p>
622
616
<p></p>
623
617
</div>
632
626
equality. The function should return <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if both values are equal
633
627
and <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise.</p>
634
628
<div class="refsect3">
635
 
<a name="id-1.6.7.8.5.5"></a><h4>Parameters</h4>
 
629
<a name="id-1.6.7.7.5.5"></a><h4>Parameters</h4>
636
630
<div class="informaltable"><table width="100%" border="0">
637
631
<colgroup>
638
632
<col width="150px" class="parameters_name">
654
648
</table></div>
655
649
</div>
656
650
<div class="refsect3">
657
 
<a name="id-1.6.7.8.5.6"></a><h4>Returns</h4>
 
651
<a name="id-1.6.7.7.5.6"></a><h4>Returns</h4>
658
652
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if <em class="parameter"><code>a</code></em>
659
653
= <em class="parameter"><code>b</code></em>
660
654
; <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> otherwise</p>
678
672
 when creating the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>, the passed
679
673
key is freed using that function.</p>
680
674
<div class="refsect3">
681
 
<a name="id-1.6.7.8.6.6"></a><h4>Parameters</h4>
 
675
<a name="id-1.6.7.7.6.6"></a><h4>Parameters</h4>
682
676
<div class="informaltable"><table width="100%" border="0">
683
677
<colgroup>
684
678
<col width="150px" class="parameters_name">
705
699
</table></div>
706
700
</div>
707
701
<div class="refsect3">
708
 
<a name="id-1.6.7.8.6.7"></a><h4>Returns</h4>
 
702
<a name="id-1.6.7.7.6.7"></a><h4>Returns</h4>
709
703
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the key did not exist yet</p>
710
704
<p></p>
711
705
</div>
727
721
 when creating the
728
722
<a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>, the old key is freed using that function.</p>
729
723
<div class="refsect3">
730
 
<a name="id-1.6.7.8.7.5"></a><h4>Parameters</h4>
 
724
<a name="id-1.6.7.7.7.5"></a><h4>Parameters</h4>
731
725
<div class="informaltable"><table width="100%" border="0">
732
726
<colgroup>
733
727
<col width="150px" class="parameters_name">
754
748
</table></div>
755
749
</div>
756
750
<div class="refsect3">
757
 
<a name="id-1.6.7.8.7.6"></a><h4>Returns</h4>
 
751
<a name="id-1.6.7.7.7.6"></a><h4>Returns</h4>
758
752
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> of the key did not exist yet</p>
759
753
<p></p>
760
754
</div>
773
767
corresponding value it is able to be stored more efficiently.  See
774
768
the discussion in the section description.</p>
775
769
<div class="refsect3">
776
 
<a name="id-1.6.7.8.8.6"></a><h4>Parameters</h4>
 
770
<a name="id-1.6.7.7.8.6"></a><h4>Parameters</h4>
777
771
<div class="informaltable"><table width="100%" border="0">
778
772
<colgroup>
779
773
<col width="150px" class="parameters_name">
795
789
</table></div>
796
790
</div>
797
791
<div class="refsect3">
798
 
<a name="id-1.6.7.8.8.7"></a><h4>Returns</h4>
 
792
<a name="id-1.6.7.7.8.7"></a><h4>Returns</h4>
799
793
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the key did not exist yet</p>
800
794
<p></p>
801
795
</div>
811
805
 is in <em class="parameter"><code>hash_table</code></em>
812
806
.</p>
813
807
<div class="refsect3">
814
 
<a name="id-1.6.7.8.9.5"></a><h4>Parameters</h4>
 
808
<a name="id-1.6.7.7.9.5"></a><h4>Parameters</h4>
815
809
<div class="informaltable"><table width="100%" border="0">
816
810
<colgroup>
817
811
<col width="150px" class="parameters_name">
841
835
g_hash_table_size (<em class="parameter"><code><a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a> *hash_table</code></em>);</pre>
842
836
<p>Returns the number of elements contained in the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>.</p>
843
837
<div class="refsect3">
844
 
<a name="id-1.6.7.8.10.5"></a><h4>Parameters</h4>
 
838
<a name="id-1.6.7.7.10.5"></a><h4>Parameters</h4>
845
839
<div class="informaltable"><table width="100%" border="0">
846
840
<colgroup>
847
841
<col width="150px" class="parameters_name">
856
850
</table></div>
857
851
</div>
858
852
<div class="refsect3">
859
 
<a name="id-1.6.7.8.10.6"></a><h4>Returns</h4>
 
853
<a name="id-1.6.7.7.10.6"></a><h4>Returns</h4>
860
854
<p> the number of key/value pairs in the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>.</p>
861
855
<p></p>
862
856
</div>
872
866
and has the value <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. If you need this distinction, use
873
867
<a class="link" href="glib-Hash-Tables.html#g-hash-table-lookup-extended" title="g_hash_table_lookup_extended ()"><code class="function">g_hash_table_lookup_extended()</code></a>.</p>
874
868
<div class="refsect3">
875
 
<a name="id-1.6.7.8.11.5"></a><h4>Parameters</h4>
 
869
<a name="id-1.6.7.7.11.5"></a><h4>Parameters</h4>
876
870
<div class="informaltable"><table width="100%" border="0">
877
871
<colgroup>
878
872
<col width="150px" class="parameters_name">
894
888
</table></div>
895
889
</div>
896
890
<div class="refsect3">
897
 
<a name="id-1.6.7.8.11.6"></a><h4>Returns</h4>
 
891
<a name="id-1.6.7.7.11.6"></a><h4>Returns</h4>
898
892
<p> the associated value, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the key is not found. </p>
899
893
<p><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></p>
900
894
</div>
917
911
of <em class="parameter"><code>hash_table</code></em>
918
912
 are <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-safe.</p>
919
913
<div class="refsect3">
920
 
<a name="id-1.6.7.8.12.6"></a><h4>Parameters</h4>
 
914
<a name="id-1.6.7.7.12.6"></a><h4>Parameters</h4>
921
915
<div class="informaltable"><table width="100%" border="0">
922
916
<colgroup>
923
917
<col width="150px" class="parameters_name">
949
943
</table></div>
950
944
</div>
951
945
<div class="refsect3">
952
 
<a name="id-1.6.7.8.12.7"></a><h4>Returns</h4>
 
946
<a name="id-1.6.7.7.12.7"></a><h4>Returns</h4>
953
947
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the key was found in the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a></p>
954
948
<p></p>
955
949
</div>
971
965
<p>See <a class="link" href="glib-Hash-Tables.html#g-hash-table-find" title="g_hash_table_find ()"><code class="function">g_hash_table_find()</code></a> for performance caveats for linear
972
966
order searches in contrast to <a class="link" href="glib-Hash-Tables.html#g-hash-table-lookup" title="g_hash_table_lookup ()"><code class="function">g_hash_table_lookup()</code></a>.</p>
973
967
<div class="refsect3">
974
 
<a name="id-1.6.7.8.13.6"></a><h4>Parameters</h4>
 
968
<a name="id-1.6.7.7.13.6"></a><h4>Parameters</h4>
975
969
<div class="informaltable"><table width="100%" border="0">
976
970
<colgroup>
977
971
<col width="150px" class="parameters_name">
1020
1014
(keep in mind that an O(n) find/foreach operation issued for all n
1021
1015
values in a hash table ends up needing O(n*n) operations).</p>
1022
1016
<div class="refsect3">
1023
 
<a name="id-1.6.7.8.14.6"></a><h4>Parameters</h4>
 
1017
<a name="id-1.6.7.7.14.6"></a><h4>Parameters</h4>
1024
1018
<div class="informaltable"><table width="100%" border="0">
1025
1019
<colgroup>
1026
1020
<col width="150px" class="parameters_name">
1047
1041
</table></div>
1048
1042
</div>
1049
1043
<div class="refsect3">
1050
 
<a name="id-1.6.7.8.14.7"></a><h4>Returns</h4>
 
1044
<a name="id-1.6.7.7.14.7"></a><h4>Returns</h4>
1051
1045
<p> The value of the first key/value pair is returned,
1052
1046
for which <em class="parameter"><code>predicate</code></em>
1053
1047
evaluates to <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>. If no pair with the
1068
1062
 
1069
1063
parameter which is passed to <a class="link" href="glib-Hash-Tables.html#g-hash-table-foreach" title="g_hash_table_foreach ()"><code class="function">g_hash_table_foreach()</code></a>.</p>
1070
1064
<div class="refsect3">
1071
 
<a name="id-1.6.7.8.15.5"></a><h4>Parameters</h4>
 
1065
<a name="id-1.6.7.7.15.5"></a><h4>Parameters</h4>
1072
1066
<div class="informaltable"><table width="100%" border="0">
1073
1067
<colgroup>
1074
1068
<col width="150px" class="parameters_name">
1107
1101
you have to make sure that any dynamically allocated values are freed
1108
1102
yourself.</p>
1109
1103
<div class="refsect3">
1110
 
<a name="id-1.6.7.8.16.6"></a><h4>Parameters</h4>
 
1104
<a name="id-1.6.7.7.16.6"></a><h4>Parameters</h4>
1111
1105
<div class="informaltable"><table width="100%" border="0">
1112
1106
<colgroup>
1113
1107
<col width="150px" class="parameters_name">
1129
1123
</table></div>
1130
1124
</div>
1131
1125
<div class="refsect3">
1132
 
<a name="id-1.6.7.8.16.7"></a><h4>Returns</h4>
 
1126
<a name="id-1.6.7.7.16.7"></a><h4>Returns</h4>
1133
1127
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the key was found and removed from the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a></p>
1134
1128
<p></p>
1135
1129
</div>
1143
1137
<p>Removes a key and its associated value from a <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a> without
1144
1138
calling the key and value destroy functions.</p>
1145
1139
<div class="refsect3">
1146
 
<a name="id-1.6.7.8.17.5"></a><h4>Parameters</h4>
 
1140
<a name="id-1.6.7.7.17.5"></a><h4>Parameters</h4>
1147
1141
<div class="informaltable"><table width="100%" border="0">
1148
1142
<colgroup>
1149
1143
<col width="150px" class="parameters_name">
1165
1159
</table></div>
1166
1160
</div>
1167
1161
<div class="refsect3">
1168
 
<a name="id-1.6.7.8.17.6"></a><h4>Returns</h4>
 
1162
<a name="id-1.6.7.7.17.6"></a><h4>Returns</h4>
1169
1163
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the key was found and removed from the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a></p>
1170
1164
<p></p>
1171
1165
</div>
1185
1179
<p>See <a class="link" href="glib-Hash-Tables.html#GHashTableIter" title="struct GHashTableIter"><span class="type">GHashTableIter</span></a> for an alternative way to loop over the
1186
1180
key/value pairs in the hash table.</p>
1187
1181
<div class="refsect3">
1188
 
<a name="id-1.6.7.8.18.6"></a><h4>Parameters</h4>
 
1182
<a name="id-1.6.7.7.18.6"></a><h4>Parameters</h4>
1189
1183
<div class="informaltable"><table width="100%" border="0">
1190
1184
<colgroup>
1191
1185
<col width="150px" class="parameters_name">
1212
1206
</table></div>
1213
1207
</div>
1214
1208
<div class="refsect3">
1215
 
<a name="id-1.6.7.8.18.7"></a><h4>Returns</h4>
 
1209
<a name="id-1.6.7.7.18.7"></a><h4>Returns</h4>
1216
1210
<p> the number of key/value pairs removed</p>
1217
1211
<p></p>
1218
1212
</div>
1231
1225
<p>See <a class="link" href="glib-Hash-Tables.html#GHashTableIter" title="struct GHashTableIter"><span class="type">GHashTableIter</span></a> for an alternative way to loop over the
1232
1226
key/value pairs in the hash table.</p>
1233
1227
<div class="refsect3">
1234
 
<a name="id-1.6.7.8.19.6"></a><h4>Parameters</h4>
 
1228
<a name="id-1.6.7.7.19.6"></a><h4>Parameters</h4>
1235
1229
<div class="informaltable"><table width="100%" border="0">
1236
1230
<colgroup>
1237
1231
<col width="150px" class="parameters_name">
1258
1252
</table></div>
1259
1253
</div>
1260
1254
<div class="refsect3">
1261
 
<a name="id-1.6.7.8.19.7"></a><h4>Returns</h4>
 
1255
<a name="id-1.6.7.7.19.7"></a><h4>Returns</h4>
1262
1256
<p> the number of key/value pairs removed.</p>
1263
1257
<p></p>
1264
1258
</div>
1274
1268
otherwise you have to make sure that any dynamically allocated
1275
1269
values are freed yourself.</p>
1276
1270
<div class="refsect3">
1277
 
<a name="id-1.6.7.8.20.6"></a><h4>Parameters</h4>
 
1271
<a name="id-1.6.7.7.20.6"></a><h4>Parameters</h4>
1278
1272
<div class="informaltable"><table width="100%" border="0">
1279
1273
<colgroup>
1280
1274
<col width="150px" class="parameters_name">
1298
1292
<p>Removes all keys and their associated values from a <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>
1299
1293
without calling the key and value destroy functions.</p>
1300
1294
<div class="refsect3">
1301
 
<a name="id-1.6.7.8.21.5"></a><h4>Parameters</h4>
 
1295
<a name="id-1.6.7.7.21.5"></a><h4>Parameters</h4>
1302
1296
<div class="informaltable"><table width="100%" border="0">
1303
1297
<colgroup>
1304
1298
<col width="150px" class="parameters_name">
1323
1317
. The returned data is valid
1324
1318
until changes to the hash release those keys.</p>
1325
1319
<div class="refsect3">
1326
 
<a name="id-1.6.7.8.22.5"></a><h4>Parameters</h4>
 
1320
<a name="id-1.6.7.7.22.5"></a><h4>Parameters</h4>
1327
1321
<div class="informaltable"><table width="100%" border="0">
1328
1322
<colgroup>
1329
1323
<col width="150px" class="parameters_name">
1338
1332
</table></div>
1339
1333
</div>
1340
1334
<div class="refsect3">
1341
 
<a name="id-1.6.7.8.22.6"></a><h4>Returns</h4>
 
1335
<a name="id-1.6.7.7.22.6"></a><h4>Returns</h4>
1342
1336
<p> a <a class="link" href="glib-Doubly-Linked-Lists.html#GList" title="struct GList"><span class="type">GList</span></a> containing all the keys inside the hash
1343
1337
table. The content of the list is owned by the hash table and
1344
1338
should not be modified or freed. Use <a class="link" href="glib-Doubly-Linked-Lists.html#g-list-free" title="g_list_free ()"><code class="function">g_list_free()</code></a> when done
1357
1351
is valid until <em class="parameter"><code>hash_table</code></em>
1358
1352
 is modified.</p>
1359
1353
<div class="refsect3">
1360
 
<a name="id-1.6.7.8.23.5"></a><h4>Parameters</h4>
 
1354
<a name="id-1.6.7.7.23.5"></a><h4>Parameters</h4>
1361
1355
<div class="informaltable"><table width="100%" border="0">
1362
1356
<colgroup>
1363
1357
<col width="150px" class="parameters_name">
1372
1366
</table></div>
1373
1367
</div>
1374
1368
<div class="refsect3">
1375
 
<a name="id-1.6.7.8.23.6"></a><h4>Returns</h4>
 
1369
<a name="id-1.6.7.7.23.6"></a><h4>Returns</h4>
1376
1370
<p> a <a class="link" href="glib-Doubly-Linked-Lists.html#GList" title="struct GList"><span class="type">GList</span></a> containing all the values inside the hash
1377
1371
table. The content of the list is owned by the hash table and
1378
1372
should not be modified or freed. Use <a class="link" href="glib-Doubly-Linked-Lists.html#g-list-free" title="g_list_free ()"><code class="function">g_list_free()</code></a> when done
1400
1394
appropriate to use <a class="link" href="glib-String-Utility-Functions.html#g-strfreev" title="g_strfreev ()"><code class="function">g_strfreev()</code></a> if you call <a class="link" href="glib-Hash-Tables.html#g-hash-table-steal-all" title="g_hash_table_steal_all ()"><code class="function">g_hash_table_steal_all()</code></a>
1401
1395
first to transfer ownership of the keys.</p>
1402
1396
<div class="refsect3">
1403
 
<a name="id-1.6.7.8.24.8"></a><h4>Parameters</h4>
 
1397
<a name="id-1.6.7.7.24.8"></a><h4>Parameters</h4>
1404
1398
<div class="informaltable"><table width="100%" border="0">
1405
1399
<colgroup>
1406
1400
<col width="150px" class="parameters_name">
1422
1416
</table></div>
1423
1417
</div>
1424
1418
<div class="refsect3">
1425
 
<a name="id-1.6.7.8.24.9"></a><h4>Returns</h4>
 
1419
<a name="id-1.6.7.7.24.9"></a><h4>Returns</h4>
1426
1420
<p> a
1427
1421
<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-terminated array containing each key from the table. </p>
1428
1422
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
1443
1437
<a class="link" href="glib-Hash-Tables.html#g-hash-table-foreach-remove" title="g_hash_table_foreach_remove ()"><code class="function">g_hash_table_foreach_remove()</code></a>. It should return <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the
1444
1438
key/value pair should be removed from the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>.</p>
1445
1439
<div class="refsect3">
1446
 
<a name="id-1.6.7.8.25.5"></a><h4>Parameters</h4>
 
1440
<a name="id-1.6.7.7.25.5"></a><h4>Parameters</h4>
1447
1441
<div class="informaltable"><table width="100%" border="0">
1448
1442
<colgroup>
1449
1443
<col width="150px" class="parameters_name">
1470
1464
</table></div>
1471
1465
</div>
1472
1466
<div class="refsect3">
1473
 
<a name="id-1.6.7.8.25.6"></a><h4>Returns</h4>
 
1467
<a name="id-1.6.7.7.25.6"></a><h4>Returns</h4>
1474
1468
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the key/value pair should be removed from the
1475
1469
<a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a></p>
1476
1470
<p></p>
1484
1478
<p>This function is deprecated and will be removed in the next major
1485
1479
release of GLib. It does nothing.</p>
1486
1480
<div class="refsect3">
1487
 
<a name="id-1.6.7.8.26.6"></a><h4>Parameters</h4>
 
1481
<a name="id-1.6.7.7.26.6"></a><h4>Parameters</h4>
1488
1482
<div class="informaltable"><table width="100%" border="0">
1489
1483
<colgroup>
1490
1484
<col width="150px" class="parameters_name">
1507
1501
<p>This function is deprecated and will be removed in the next major
1508
1502
release of GLib. It does nothing.</p>
1509
1503
<div class="refsect3">
1510
 
<a name="id-1.6.7.8.27.6"></a><h4>Parameters</h4>
 
1504
<a name="id-1.6.7.7.27.6"></a><h4>Parameters</h4>
1511
1505
<div class="informaltable"><table width="100%" border="0">
1512
1506
<colgroup>
1513
1507
<col width="150px" class="parameters_name">
1534
1528
functions you supplied will be called on all keys and values during the
1535
1529
destruction phase.</p>
1536
1530
<div class="refsect3">
1537
 
<a name="id-1.6.7.8.28.5"></a><h4>Parameters</h4>
 
1531
<a name="id-1.6.7.7.28.5"></a><h4>Parameters</h4>
1538
1532
<div class="informaltable"><table width="100%" border="0">
1539
1533
<colgroup>
1540
1534
<col width="150px" class="parameters_name">
1558
1552
 by one.
1559
1553
This function is MT-safe and may be called from any thread.</p>
1560
1554
<div class="refsect3">
1561
 
<a name="id-1.6.7.8.29.5"></a><h4>Parameters</h4>
 
1555
<a name="id-1.6.7.7.29.5"></a><h4>Parameters</h4>
1562
1556
<div class="informaltable"><table width="100%" border="0">
1563
1557
<colgroup>
1564
1558
<col width="150px" class="parameters_name">
1573
1567
</table></div>
1574
1568
</div>
1575
1569
<div class="refsect3">
1576
 
<a name="id-1.6.7.8.29.6"></a><h4>Returns</h4>
 
1570
<a name="id-1.6.7.7.29.6"></a><h4>Returns</h4>
1577
1571
<p> the passed in <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a></p>
1578
1572
<p></p>
1579
1573
</div>
1590
1584
destroyed, and all memory allocated by the hash table is released.
1591
1585
This function is MT-safe and may be called from any thread.</p>
1592
1586
<div class="refsect3">
1593
 
<a name="id-1.6.7.8.30.5"></a><h4>Parameters</h4>
 
1587
<a name="id-1.6.7.7.30.5"></a><h4>Parameters</h4>
1594
1588
<div class="informaltable"><table width="100%" border="0">
1595
1589
<colgroup>
1596
1590
<col width="150px" class="parameters_name">
1628
1622
6
1629
1623
7
1630
1624
8</pre></td>
1631
 
        <td class="listing_code"><pre class="programlisting"><span class="usertype">GHashTableIter</span><span class="normal"> iter</span><span class="symbol">;</span>
1632
 
<span class="usertype">gpointer</span><span class="normal"> key</span><span class="symbol">,</span><span class="normal"> value</span><span class="symbol">;</span>
 
1625
        <td class="listing_code"><pre class="programlisting">GHashTableIter iter<span class="gtkdoc opt">;</span>
 
1626
gpointer key<span class="gtkdoc opt">,</span> value<span class="gtkdoc opt">;</span>
1633
1627
 
1634
 
<span class="function"><a href="glib-Hash-Tables.html#g-hash-table-iter-init">g_hash_table_iter_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> hash_table</span><span class="symbol">);</span>
1635
 
<span class="keyword">while</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-Hash-Tables.html#g-hash-table-iter-next">g_hash_table_iter_next</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">iter</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">key</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">value</span><span class="symbol">))</span>
1636
 
<span class="normal">  </span><span class="cbracket">{</span>
1637
 
<span class="normal">    </span><span class="comment">// do something with key and value</span>
1638
 
<span class="normal">  </span><span class="cbracket">}</span></pre></td>
 
1628
<span class="function"><a href="glib-Hash-Tables.html#g-hash-table-iter-init">g_hash_table_iter_init</a></span> <span class="gtkdoc opt">(&amp;</span>iter<span class="gtkdoc opt">,</span> hash_table<span class="gtkdoc opt">);</span>
 
1629
<span class="keyword">while</span> <span class="gtkdoc opt">(</span><span class="function"><a href="glib-Hash-Tables.html#g-hash-table-iter-next">g_hash_table_iter_next</a></span> <span class="gtkdoc opt">(&amp;</span>iter<span class="gtkdoc opt">, &amp;</span>key<span class="gtkdoc opt">, &amp;</span>value<span class="gtkdoc opt">))</span>
 
1630
  <span class="gtkdoc opt">{</span>
 
1631
    <span class="gtkdoc slc">// do something with key and value</span>
 
1632
  <span class="gtkdoc opt">}</span></pre></td>
1639
1633
      </tr>
1640
1634
    </tbody>
1641
1635
  </table>
1643
1637
 
1644
1638
<p></p>
1645
1639
<div class="refsect3">
1646
 
<a name="id-1.6.7.8.31.7"></a><h4>Parameters</h4>
 
1640
<a name="id-1.6.7.7.31.7"></a><h4>Parameters</h4>
1647
1641
<div class="informaltable"><table width="100%" border="0">
1648
1642
<colgroup>
1649
1643
<col width="150px" class="parameters_name">
1680
1674
 and <em class="parameter"><code>value</code></em>
1681
1675
 are not set, and the iterator becomes invalid.</p>
1682
1676
<div class="refsect3">
1683
 
<a name="id-1.6.7.8.32.5"></a><h4>Parameters</h4>
 
1677
<a name="id-1.6.7.7.32.5"></a><h4>Parameters</h4>
1684
1678
<div class="informaltable"><table width="100%" border="0">
1685
1679
<colgroup>
1686
1680
<col width="150px" class="parameters_name">
1707
1701
</table></div>
1708
1702
</div>
1709
1703
<div class="refsect3">
1710
 
<a name="id-1.6.7.8.32.6"></a><h4>Returns</h4>
 
1704
<a name="id-1.6.7.7.32.6"></a><h4>Returns</h4>
1711
1705
<p> <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> if the end of the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a> has been reached.</p>
1712
1706
<p></p>
1713
1707
</div>
1721
1715
<p>Returns the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a> associated with <em class="parameter"><code>iter</code></em>
1722
1716
.</p>
1723
1717
<div class="refsect3">
1724
 
<a name="id-1.6.7.8.33.5"></a><h4>Parameters</h4>
 
1718
<a name="id-1.6.7.7.33.5"></a><h4>Parameters</h4>
1725
1719
<div class="informaltable"><table width="100%" border="0">
1726
1720
<colgroup>
1727
1721
<col width="150px" class="parameters_name">
1736
1730
</table></div>
1737
1731
</div>
1738
1732
<div class="refsect3">
1739
 
<a name="id-1.6.7.8.33.6"></a><h4>Returns</h4>
 
1733
<a name="id-1.6.7.7.33.6"></a><h4>Returns</h4>
1740
1734
<p> the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a> associated with <em class="parameter"><code>iter</code></em>
1741
1735
.</p>
1742
1736
<p></p>
1756
1750
 when creating the
1757
1751
<a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>, the old value is freed using that function.</p>
1758
1752
<div class="refsect3">
1759
 
<a name="id-1.6.7.8.34.6"></a><h4>Parameters</h4>
 
1753
<a name="id-1.6.7.7.34.6"></a><h4>Parameters</h4>
1760
1754
<div class="informaltable"><table width="100%" border="0">
1761
1755
<colgroup>
1762
1756
<col width="150px" class="parameters_name">
1792
1786
the key and value are freed using the supplied destroy functions,
1793
1787
otherwise you have to make sure that any dynamically allocated
1794
1788
values are freed yourself.</p>
 
1789
<p>It is safe to continue iterating the <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a> afterward:</p>
 
1790
<div class="informalexample">
 
1791
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
1792
    <tbody>
 
1793
      <tr>
 
1794
        <td class="listing_lines" align="right"><pre>1
 
1795
2
 
1796
3
 
1797
4
 
1798
5</pre></td>
 
1799
        <td class="listing_code"><pre class="programlisting"><span class="keyword">while</span> <span class="gtkdoc opt">(</span><span class="function"><a href="glib-Hash-Tables.html#g-hash-table-iter-next">g_hash_table_iter_next</a></span> <span class="gtkdoc opt">(&amp;</span>iter<span class="gtkdoc opt">, &amp;</span>key<span class="gtkdoc opt">, &amp;</span>value<span class="gtkdoc opt">))</span>
 
1800
  <span class="gtkdoc opt">{</span>
 
1801
    <span class="keyword">if</span> <span class="gtkdoc opt">(</span>condition<span class="gtkdoc opt">)</span>
 
1802
      <span class="function"><a href="glib-Hash-Tables.html#g-hash-table-iter-remove">g_hash_table_iter_remove</a></span> <span class="gtkdoc opt">(&amp;</span>iter<span class="gtkdoc opt">);</span>
 
1803
  <span class="gtkdoc opt">}</span></pre></td>
 
1804
      </tr>
 
1805
    </tbody>
 
1806
  </table>
 
1807
</div>
 
1808
 
 
1809
<p></p>
1795
1810
<div class="refsect3">
1796
 
<a name="id-1.6.7.8.35.6"></a><h4>Parameters</h4>
 
1811
<a name="id-1.6.7.7.35.9"></a><h4>Parameters</h4>
1797
1812
<div class="informaltable"><table width="100%" border="0">
1798
1813
<colgroup>
1799
1814
<col width="150px" class="parameters_name">
1820
1835
after <a class="link" href="glib-Hash-Tables.html#g-hash-table-iter-next" title="g_hash_table_iter_next ()"><code class="function">g_hash_table_iter_next()</code></a> returned <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a>, and cannot
1821
1836
be called more than once for the same key/value pair.</p>
1822
1837
<div class="refsect3">
1823
 
<a name="id-1.6.7.8.36.5"></a><h4>Parameters</h4>
 
1838
<a name="id-1.6.7.7.36.5"></a><h4>Parameters</h4>
1824
1839
<div class="informaltable"><table width="100%" border="0">
1825
1840
<colgroup>
1826
1841
<col width="150px" class="parameters_name">
1850
1865
<p>This equality function is also appropriate for keys that are integers
1851
1866
stored in pointers, such as <code class="literal">GINT_TO_POINTER (n)</code>.</p>
1852
1867
<div class="refsect3">
1853
 
<a name="id-1.6.7.8.37.6"></a><h4>Parameters</h4>
 
1868
<a name="id-1.6.7.7.37.6"></a><h4>Parameters</h4>
1854
1869
<div class="informaltable"><table width="100%" border="0">
1855
1870
<colgroup>
1856
1871
<col width="150px" class="parameters_name">
1873
1888
</table></div>
1874
1889
</div>
1875
1890
<div class="refsect3">
1876
 
<a name="id-1.6.7.8.37.7"></a><h4>Returns</h4>
 
1891
<a name="id-1.6.7.7.37.7"></a><h4>Returns</h4>
1877
1892
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the two keys match.</p>
1878
1893
<p></p>
1879
1894
</div>
1891
1906
<p>This hash function is also appropriate for keys that are integers
1892
1907
stored in pointers, such as <code class="literal">GINT_TO_POINTER (n)</code>.</p>
1893
1908
<div class="refsect3">
1894
 
<a name="id-1.6.7.8.38.6"></a><h4>Parameters</h4>
 
1909
<a name="id-1.6.7.7.38.6"></a><h4>Parameters</h4>
1895
1910
<div class="informaltable"><table width="100%" border="0">
1896
1911
<colgroup>
1897
1912
<col width="150px" class="parameters_name">
1906
1921
</table></div>
1907
1922
</div>
1908
1923
<div class="refsect3">
1909
 
<a name="id-1.6.7.8.38.7"></a><h4>Returns</h4>
 
1924
<a name="id-1.6.7.7.38.7"></a><h4>Returns</h4>
1910
1925
<p> a hash value corresponding to the key.</p>
1911
1926
<p></p>
1912
1927
</div>
1927
1942
directly: if your hash table's keys are of the form
1928
1943
<code class="literal">GINT_TO_POINTER (n)</code>, use <a class="link" href="glib-Hash-Tables.html#g-direct-equal" title="g_direct_equal ()"><code class="function">g_direct_equal()</code></a> instead.</p>
1929
1944
<div class="refsect3">
1930
 
<a name="id-1.6.7.8.39.6"></a><h4>Parameters</h4>
 
1945
<a name="id-1.6.7.7.39.6"></a><h4>Parameters</h4>
1931
1946
<div class="informaltable"><table width="100%" border="0">
1932
1947
<colgroup>
1933
1948
<col width="150px" class="parameters_name">
1950
1965
</table></div>
1951
1966
</div>
1952
1967
<div class="refsect3">
1953
 
<a name="id-1.6.7.8.39.7"></a><h4>Returns</h4>
 
1968
<a name="id-1.6.7.7.39.7"></a><h4>Returns</h4>
1954
1969
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the two keys match.</p>
1955
1970
<p></p>
1956
1971
</div>
1968
1983
directly: if your hash table's keys are of the form
1969
1984
<code class="literal">GINT_TO_POINTER (n)</code>, use <a class="link" href="glib-Hash-Tables.html#g-direct-hash" title="g_direct_hash ()"><code class="function">g_direct_hash()</code></a> instead.</p>
1970
1985
<div class="refsect3">
1971
 
<a name="id-1.6.7.8.40.6"></a><h4>Parameters</h4>
 
1986
<a name="id-1.6.7.7.40.6"></a><h4>Parameters</h4>
1972
1987
<div class="informaltable"><table width="100%" border="0">
1973
1988
<colgroup>
1974
1989
<col width="150px" class="parameters_name">
1983
1998
</table></div>
1984
1999
</div>
1985
2000
<div class="refsect3">
1986
 
<a name="id-1.6.7.8.40.7"></a><h4>Returns</h4>
 
2001
<a name="id-1.6.7.7.40.7"></a><h4>Returns</h4>
1987
2002
<p> a hash value corresponding to the key.</p>
1988
2003
<p></p>
1989
2004
</div>
2001
2016
parameter, when using non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> pointers to 64-bit integers as keys in a
2002
2017
<a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>.</p>
2003
2018
<div class="refsect3">
2004
 
<a name="id-1.6.7.8.41.5"></a><h4>Parameters</h4>
 
2019
<a name="id-1.6.7.7.41.5"></a><h4>Parameters</h4>
2005
2020
<div class="informaltable"><table width="100%" border="0">
2006
2021
<colgroup>
2007
2022
<col width="150px" class="parameters_name">
2024
2039
</table></div>
2025
2040
</div>
2026
2041
<div class="refsect3">
2027
 
<a name="id-1.6.7.8.41.6"></a><h4>Returns</h4>
 
2042
<a name="id-1.6.7.7.41.6"></a><h4>Returns</h4>
2028
2043
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the two keys match.</p>
2029
2044
<p></p>
2030
2045
</div>
2041
2056
when using non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> pointers to 64-bit integer values as keys in a
2042
2057
<a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>.</p>
2043
2058
<div class="refsect3">
2044
 
<a name="id-1.6.7.8.42.6"></a><h4>Parameters</h4>
 
2059
<a name="id-1.6.7.7.42.6"></a><h4>Parameters</h4>
2045
2060
<div class="informaltable"><table width="100%" border="0">
2046
2061
<colgroup>
2047
2062
<col width="150px" class="parameters_name">
2056
2071
</table></div>
2057
2072
</div>
2058
2073
<div class="refsect3">
2059
 
<a name="id-1.6.7.8.42.7"></a><h4>Returns</h4>
 
2074
<a name="id-1.6.7.7.42.7"></a><h4>Returns</h4>
2060
2075
<p> a hash value corresponding to the key.</p>
2061
2076
<p></p>
2062
2077
</div>
2075
2090
parameter, when using non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> pointers to doubles as keys in a
2076
2091
<a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>.</p>
2077
2092
<div class="refsect3">
2078
 
<a name="id-1.6.7.8.43.5"></a><h4>Parameters</h4>
 
2093
<a name="id-1.6.7.7.43.5"></a><h4>Parameters</h4>
2079
2094
<div class="informaltable"><table width="100%" border="0">
2080
2095
<colgroup>
2081
2096
<col width="150px" class="parameters_name">
2098
2113
</table></div>
2099
2114
</div>
2100
2115
<div class="refsect3">
2101
 
<a name="id-1.6.7.8.43.6"></a><h4>Returns</h4>
 
2116
<a name="id-1.6.7.7.43.6"></a><h4>Returns</h4>
2102
2117
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the two keys match.</p>
2103
2118
<p></p>
2104
2119
</div>
2116
2131
 parameter,
2117
2132
when using non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> pointers to doubles as keys in a <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>.</p>
2118
2133
<div class="refsect3">
2119
 
<a name="id-1.6.7.8.44.5"></a><h4>Parameters</h4>
 
2134
<a name="id-1.6.7.7.44.5"></a><h4>Parameters</h4>
2120
2135
<div class="informaltable"><table width="100%" border="0">
2121
2136
<colgroup>
2122
2137
<col width="150px" class="parameters_name">
2131
2146
</table></div>
2132
2147
</div>
2133
2148
<div class="refsect3">
2134
 
<a name="id-1.6.7.8.44.6"></a><h4>Returns</h4>
 
2149
<a name="id-1.6.7.7.44.6"></a><h4>Returns</h4>
2135
2150
<p> a hash value corresponding to the key.</p>
2136
2151
<p></p>
2137
2152
</div>
2152
2167
function. For a general-purpose, <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>-safe string comparison function,
2153
2168
see <a class="link" href="glib-String-Utility-Functions.html#g-strcmp0" title="g_strcmp0 ()"><code class="function">g_strcmp0()</code></a>.</p>
2154
2169
<div class="refsect3">
2155
 
<a name="id-1.6.7.8.45.6"></a><h4>Parameters</h4>
 
2170
<a name="id-1.6.7.7.45.6"></a><h4>Parameters</h4>
2156
2171
<div class="informaltable"><table width="100%" border="0">
2157
2172
<colgroup>
2158
2173
<col width="150px" class="parameters_name">
2175
2190
</table></div>
2176
2191
</div>
2177
2192
<div class="refsect3">
2178
 
<a name="id-1.6.7.8.45.7"></a><h4>Returns</h4>
 
2193
<a name="id-1.6.7.7.45.7"></a><h4>Returns</h4>
2179
2194
<p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the two keys match</p>
2180
2195
<p></p>
2181
2196
</div>
2195
2210
 parameter,
2196
2211
when using non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> strings as keys in a <a class="link" href="glib-Hash-Tables.html#GHashTable" title="GHashTable"><span class="type">GHashTable</span></a>.</p>
2197
2212
<div class="refsect3">
2198
 
<a name="id-1.6.7.8.46.7"></a><h4>Parameters</h4>
 
2213
<a name="id-1.6.7.7.46.7"></a><h4>Parameters</h4>
2199
2214
<div class="informaltable"><table width="100%" border="0">
2200
2215
<colgroup>
2201
2216
<col width="150px" class="parameters_name">
2210
2225
</table></div>
2211
2226
</div>
2212
2227
<div class="refsect3">
2213
 
<a name="id-1.6.7.8.46.8"></a><h4>Returns</h4>
 
2228
<a name="id-1.6.7.7.46.8"></a><h4>Returns</h4>
2214
2229
<p> a hash value corresponding to the key</p>
2215
2230
<p></p>
2216
2231
</div>