Creates a new #ECollator for the given locale,
the returned collator should be freed with e_collator_unref().
The locale under which to sort
Compares str_a
with str_b,
the order of strings is determined by the parameters of collator
.
The result
will be set to integer less than, equal to, or greater than zero if str_a
is found,
respectively, to be less than, to match, or be greater than str_b
.
Either str_a
or str_b
can be %NULL, %NULL strings are considered to sort below other strings.
This function will first ensure that both strings are valid UTF-8.
A string to compare
The string to compare with str_a
Generates a collation key for str,
the result of comparing
two collation keys with strcmp() will be the same result
of calling e_collator_collate() on the same original strings.
This function will first ensure that str
is valid UTF-8 encoded.
The string to generate a collation key for
Generates a sort key for the given alphabetic index
.
The generated sort key is guaranteed to sort below any sort keys for words beginning with any variant of the given letter.
For instance, a sort key generated for the index 5 of a latin alphabet, where the fifth index is 'E' will sort below any sort keys generated for words starting with the characters 'e', 'E', 'é', 'É', 'è' or 'È'. It will also sort above any sort keys generated for words starting with the characters 'd' or 'D'.
An index into the alphabetic labels
Checks which index, as determined by e_collator_get_index_labels(),
that str
should sort under.
A string
Fetches the displayable labels and index positions for the active alphabet.
Increases the reference count of collator
.
Decreases the reference count of collator
.
If the reference count reaches 0 then the collator is freed
Creates a new #ECollator for the given locale,
the returned collator should be freed with e_collator_unref().
The locale under which to sort
Creates a new #ECollator for the given locale,
the returned collator should be freed with e_collator_unref().
In addition, this also reliably interprets the country
code from the locale
string and stores it to country_code
.
The locale under which to sort
An opaque object used for locale specific string comparisons and sort ordering.