mention the fact that the tree is traversed in sorted order.

2001-12-05  Sven Neumann  <sven@gimp.org>

	* glib/gtree.c (g_tree_foreach): mention the fact that the tree is
	traversed in sorted order.
This commit is contained in:
Sven Neumann 2001-12-05 01:38:12 +00:00 committed by Sven Neumann
parent a5fb0b8069
commit 5a30ea7ee4
9 changed files with 48 additions and 7 deletions

View File

@ -1,3 +1,8 @@
2001-12-05 Sven Neumann <sven@gimp.org>
* glib/gtree.c (g_tree_foreach): mention the fact that the tree is
traversed in sorted order.
2001-12-03 Manish Singh <yosh@gimp.org> 2001-12-03 Manish Singh <yosh@gimp.org>
* tests/module-test.c: g_module_symbol takes a gpointer *, not just * tests/module-test.c: g_module_symbol takes a gpointer *, not just

View File

@ -1,3 +1,8 @@
2001-12-05 Sven Neumann <sven@gimp.org>
* glib/gtree.c (g_tree_foreach): mention the fact that the tree is
traversed in sorted order.
2001-12-03 Manish Singh <yosh@gimp.org> 2001-12-03 Manish Singh <yosh@gimp.org>
* tests/module-test.c: g_module_symbol takes a gpointer *, not just * tests/module-test.c: g_module_symbol takes a gpointer *, not just

View File

@ -1,3 +1,8 @@
2001-12-05 Sven Neumann <sven@gimp.org>
* glib/gtree.c (g_tree_foreach): mention the fact that the tree is
traversed in sorted order.
2001-12-03 Manish Singh <yosh@gimp.org> 2001-12-03 Manish Singh <yosh@gimp.org>
* tests/module-test.c: g_module_symbol takes a gpointer *, not just * tests/module-test.c: g_module_symbol takes a gpointer *, not just

View File

@ -1,3 +1,8 @@
2001-12-05 Sven Neumann <sven@gimp.org>
* glib/gtree.c (g_tree_foreach): mention the fact that the tree is
traversed in sorted order.
2001-12-03 Manish Singh <yosh@gimp.org> 2001-12-03 Manish Singh <yosh@gimp.org>
* tests/module-test.c: g_module_symbol takes a gpointer *, not just * tests/module-test.c: g_module_symbol takes a gpointer *, not just

View File

@ -1,3 +1,8 @@
2001-12-05 Sven Neumann <sven@gimp.org>
* glib/gtree.c (g_tree_foreach): mention the fact that the tree is
traversed in sorted order.
2001-12-03 Manish Singh <yosh@gimp.org> 2001-12-03 Manish Singh <yosh@gimp.org>
* tests/module-test.c: g_module_symbol takes a gpointer *, not just * tests/module-test.c: g_module_symbol takes a gpointer *, not just

View File

@ -1,3 +1,8 @@
2001-12-05 Sven Neumann <sven@gimp.org>
* glib/gtree.c (g_tree_foreach): mention the fact that the tree is
traversed in sorted order.
2001-12-03 Manish Singh <yosh@gimp.org> 2001-12-03 Manish Singh <yosh@gimp.org>
* tests/module-test.c: g_module_symbol takes a gpointer *, not just * tests/module-test.c: g_module_symbol takes a gpointer *, not just

View File

@ -1,3 +1,8 @@
2001-12-05 Sven Neumann <sven@gimp.org>
* glib/gtree.c (g_tree_foreach): mention the fact that the tree is
traversed in sorted order.
2001-12-03 Manish Singh <yosh@gimp.org> 2001-12-03 Manish Singh <yosh@gimp.org>
* tests/module-test.c: g_module_symbol takes a gpointer *, not just * tests/module-test.c: g_module_symbol takes a gpointer *, not just

View File

@ -1,3 +1,8 @@
2001-12-05 Sven Neumann <sven@gimp.org>
* glib/gtree.c (g_tree_foreach): mention the fact that the tree is
traversed in sorted order.
2001-12-03 Manish Singh <yosh@gimp.org> 2001-12-03 Manish Singh <yosh@gimp.org>
* tests/module-test.c: g_module_symbol takes a gpointer *, not just * tests/module-test.c: g_module_symbol takes a gpointer *, not just

View File

@ -442,11 +442,12 @@ g_tree_lookup_extended (GTree *tree,
* *
* Calls the given function for each of the key/value pairs in the #GTree. * Calls the given function for each of the key/value pairs in the #GTree.
* The function is passed the key and value of each pair, and the given * The function is passed the key and value of each pair, and the given
* @data parameter. The tree may not be modified while iterating over * @data parameter. The tree is traversed in sorted order.
* it (you can't add/remove items). To remove all items matching *
* a predicate, you need to add each item to a list as in your * The tree may not be modified while iterating over it (you can't
* #GTraverseFunc as you walk over the tree, then walk the list * add/remove items). To remove all items matching a predicate, you need
* and remove each item. * to add each item to a list in your #GTraverseFunc as you walk over
* the tree, then walk the list and remove each item.
**/ **/
void void
g_tree_foreach (GTree *tree, g_tree_foreach (GTree *tree,
@ -472,8 +473,8 @@ g_tree_foreach (GTree *tree,
* *
* Calls the given function for each node in the GTree. This function is * Calls the given function for each node in the GTree. This function is
* deprecated, since the order of a balanced tree is somewhat arbitrary. * deprecated, since the order of a balanced tree is somewhat arbitrary.
* If you just want to visit all nodes in some order, use g_tree_foreach() * If you just want to visit all nodes in sorted order, use g_tree_foreach()
* instead. If you really need to visit nodes in a specific order, consider * instead. If you really need to visit nodes in a different order, consider
* using an <link linkend="glib-N-ary-Trees">N-ary Tree</link>. * using an <link linkend="glib-N-ary-Trees">N-ary Tree</link>.
**/ **/
void void