luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-03-23 16:10:03 +01:00
Code Issues Packages Projects Releases Wiki Activity

Forgotten file

Browse Source
This commit is contained in:
Matthias Clasen 2006-12-27 05:10:54 +00:00
parent 3ab1139aef
commit 33acbf5b76
1 changed files with 14 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
glib/gunicollate.c
View File

@ -54,11 +54,11 @@ msc_strxfrm_wrapper (char *string1,
* @str2: a UTF-8 encoded string * @str2: a UTF-8 encoded string
* *
* Compares two strings for ordering using the linguistically * Compares two strings for ordering using the linguistically
* correct rules for the current locale. When sorting a large * correct rules for the <link linkend="setlocale">current locale</link>.
* number of strings, it will be significantly faster to * When sorting a large number of strings, it will be significantly
* obtain collation keys with g_utf8_collate_key() and * faster to obtain collation keys with g_utf8_collate_key() and
* compare the keys with strcmp() when * compare the keys with strcmp() when sorting instead of sorting
* sorting instead of sorting the original strings. * the original strings.
* *
* Return value: &lt; 0 if @str1 compares before @str2, * Return value: &lt; 0 if @str1 compares before @str2,
* 0 if they compare equal, &gt; 0 if @str1 compares after @str2. * 0 if they compare equal, &gt; 0 if @str1 compares after @str2.
@ -184,9 +184,13 @@ utf8_encode (char *buf, wchar_t val)
* Converts a string into a collation key that can be compared * Converts a string into a collation key that can be compared
* with other collation keys produced by the same function using * with other collation keys produced by the same function using
* strcmp(). * strcmp().
*
* The results of comparing the collation keys of two strings * The results of comparing the collation keys of two strings
* with strcmp() will always be the same as * with strcmp() will always be the same as comparing the two
* comparing the two original keys with g_utf8_collate(). * original keys with g_utf8_collate().
*
* Note that this function depends on the
* <link linkend="setlocale">current locale</link>.
* *
* Return value: a newly allocated string. This string should * Return value: a newly allocated string. This string should
* be freed with g_free() when you are done with it. * be freed with g_free() when you are done with it.
@ -303,6 +307,9 @@ g_utf8_collate_key (const gchar *str,
* would like to treat numbers intelligently so that "file1" "file10" "file5" * would like to treat numbers intelligently so that "file1" "file10" "file5"
* is sorted as "file1" "file5" "file10". * is sorted as "file1" "file5" "file10".
* *
* Note that this function depends on the
* <link linkend="setlocale">current locale</link>.
*
* Return value: a newly allocated string. This string should * Return value: a newly allocated string. This string should
* be freed with g_free() when you are done with it. * be freed with g_free() when you are done with it.
* *