collate

Compares two strings for ordering using the linguistically correct rules for the current locale.

When sorting a large number of strings, it will be significantly faster to obtain collation keys with collate_key and compare the keys with strcmp when sorting instead of sorting the original strings.

Parameters:

str2	a UTF-8 encoded string
str1	a UTF-8 encoded string

Returns:

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