luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-06-08 13:50:07 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: Add the cute trick comment to all sort functions

Browse Source 
Thanks to Sebastian Dröge for pointing out there's more than
g_array_sort() and I hadn't in fact added the comment to g_array_sort()
in 80928ea403cfff5ffaa4bc73e84e3d4ebcb09123
This commit is contained in:
Benjamin Otte 2011-05-15 16:16:30 +02:00
parent 80928ea403
commit cb7a5a8e94
1 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
glib/garray.c
View File

@ -616,7 +616,10 @@ g_array_remove_range (GArray *farray,
* greater than second arg). * greater than second arg).
* *
* If two array elements compare equal, their order in the sorted array * If two array elements compare equal, their order in the sorted array
* is undefined. * is undefined. If you want equal elements to keep their order - ie
* you want a stable sort - you can write a comparison function that,
* if two elements would otherwise compare equal, it compares them by
* their addresses.
**/ **/
void void
g_array_sort (GArray *farray, g_array_sort (GArray *farray,
@ -1238,7 +1241,10 @@ g_ptr_array_add (GPtrArray *farray,
* greater than second arg). * greater than second arg).
* *
* If two array elements compare equal, their order in the sorted array * If two array elements compare equal, their order in the sorted array
* is undefined. * is undefined. If you want equal elements to keep their order - ie
* you want a stable sort - you can write a comparison function that,
* if two elements would otherwise compare equal, it compares them by
* their addresses.
* *
* <note><para>The comparison function for g_ptr_array_sort() doesn't * <note><para>The comparison function for g_ptr_array_sort() doesn't
* take the pointers from the array as arguments, it takes pointers to * take the pointers from the array as arguments, it takes pointers to