3.9.1. Filter expressions
The filter expression language supports the following constants, operators, and functions. It also allows for referencing data element attributes by putting the attribute name in square brackets [attribute] and to change evaluation order by putting expression parts in regular round brackets (…).
TODO: operator precedence
Constants
true-
logical true
false-
logical false
pi-
3.14159…
deg_to_rad-
0.01745… (pi/180)
rad_to_deg-
57.295… (180/pi)
Operators
+-*/%and,&&or,||not,!=,eq,is!=,<>,neq<,lt<=,le>,gt>=,ge.match('regexp')-
check whether [str] matches the 'regexp' expression pattern
.replace('regexp', 'replace_with')-
replace text based on regular expression
Operator Precedence
| Level | Operators | Grouping |
|---|---|---|
1 |
literals, |
– |
2 |
unary |
– |
3 |
|
left to right |
4 |
|
left to right |
5 |
|
left to right |
6 |
|
left to right |
7 |
|
– |
8 |
|
left to right |
Note that these work a bit different to what one may be used to:
-
and/orhave the same precedence, evaluated left to right:true or true and false→((true or true) and false)= false (SQL, C and Python would give true). -
notbinds looser than comparisons:not 1 = 2→not (1=2). -
not not trueis a parse error; use parentheses. -
Comparisons chain as booleans, not as ranges:
1 < 2 < 3→((1<2)<3). -
Equality binds looser than
</>:1 = 1 < 2→1 = (1<2).
Functions
sin(x)-
Sinus
cos(x)-
Cosinus
tan(x)-
Tangens
atan(x)-
Arc Tangens
exp(x)-
ex log(x)-
natural logarithm of
x pow(x,y)-
xy abs(x)-
positive absolute value of
x min(x,y)-
minimum value
max(x,y)-
maximum value
length(str)-
string length
User Variables
User variables are referenced by a leading @ followed by the name; they can be set
when requesting to actually render a styleshet.
With the Python bindings this is done by calling the render_with_vars() method
instead of just `render(). Unfortunately this method so far only exists for the
Agg render backend, but not for Cairo Graphics or native SVG backends yet.