StringSorter
GtkStringSorter
is a GtkSorter
that compares strings.
It does the comparison in a linguistically correct way using the current locale by normalizing Unicode strings and possibly case-folding them before performing the comparison.
To obtain the strings to compare, this sorter evaluates a
Expression
.
Constructors
- class StringSorter
- classmethod new(expression: Expression | None = None) StringSorter
Creates a new string sorter that compares items using the given
expression
.Unless an expression is set on it, this sorter will always compare items as invalid.
- Parameters:
expression – The expression to evaluate
Methods
- class StringSorter
-
- get_expression() Expression | None
Gets the expression that is evaluated to obtain strings from items.
- set_collation(collation: Collation) None
Sets the collation method to use for sorting.
Added in version 4.10.
- Parameters:
collation – the collation method
- set_expression(expression: Expression | None = None) None
Sets the expression that is evaluated to obtain strings from items.
The expression must have the type
str
.- Parameters:
expression – a
GtkExpression
Properties
- class StringSorter
- props.collation: Collation
The collation method to use for sorting.
The
GTK_COLLATION_NONE
value is useful when the expression already returns collation keys, or strings that need to be compared byte-by-byte.The default value,
GTK_COLLATION_UNICODE
, compares strings according to the Unicode collation algorithm.Added in version 4.10.
- props.expression: Expression
The expression to evaluate on item to get a string to compare with.