luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-11-05 08:56:16 +01: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 80928ea403
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).
*
* 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
g_array_sort (GArray *farray,
@ -1238,7 +1241,10 @@ g_ptr_array_add (GPtrArray *farray,
* greater than second arg).
*
* 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
* take the pointers from the array as arguments, it takes pointers to