be freed with [glib.global.gfree] when you are done with it.
utf8CollateKey
fn
string utf8CollateKey(string str)Converts a string into a collation key that can be compared with other collation keys produced by the same function using strcmp().
The results of comparing the collation keys of two strings with strcmp() will always be the same as comparing the two original keys with [glib.global.utf8Collate].
Note that this function depends on the [current locale][setlocale].
Parameters
str | a UTF-8 encoded string. |
Returns
a newly allocated string. This string should