utf8Collate

Compares two strings for ordering using the linguistically correct rules for the [current locale]setlocale. When sorting a large number of strings, it will be significantly faster to obtain collation keys with glib.global.utf8CollateKey and compare the keys with strcmp() when sorting instead of sorting the original strings.

If the two strings are not comparable due to being in different collation sequences, the result is undefined. This can happen if the strings are in different language scripts, for example.

int
utf8Collate
(
string str1
,
string str2
)

Parameters

str1 string

a UTF-8 encoded string

str2 string

a UTF-8 encoded string

Return Value

Type: int

< 0 if str1 compares before str2, 0 if they compare equal, > 0 if str1 compares after str2.