Function
AdwBreakpointConditionparse
since: 1.4
Declaration [src]
AdwBreakpointCondition*
adw_breakpoint_condition_parse (
const char* str
)
Description [src]
Parses a condition from a string.
Length conditions are specified as <type>: <value>[<unit>], where:
<type>can bemin-width,max-width,min-heightormax-height<value>is a fractional number<unit>can bepx,ptorsp
If the unit is omitted, px is assumed.
See adw_breakpoint_condition_new_length().
Examples:
min-width: 500pxmin-height: 400ptmax-width: 100spmax-height: 500
Ratio conditions are specified as <type>: <width>[/<height>], where:
<type>can bemin-aspect-ratioormax-aspect-ratio<width>and<height>are integer numbers
See adw_breakpoint_condition_new_ratio().
The ratio is represented as <width> divided by <height>.
If <height> is omitted, it’s assumed to be 1.
Examples:
min-aspect-ratio: 4/3max-aspect-ratio: 1
The logical operators and, or can be used to compose a complex condition
as follows:
<condition> and <condition>: the condition is true when both<condition>s are true, same as when usingadw_breakpoint_condition_new_and()<condition> or <condition>: the condition is true when either of the<condition>s is true, same as when usingadw_breakpoint_condition_new_or()
Examples:
min-width: 400px and max-aspect-ratio: 4/3max-width: 360sp or max-width: 360px
Conditions can be further nested using parentheses, for example:
min-width: 400px and (max-aspect-ratio: 4/3 or max-height: 400px)
If parentheses are omitted, the first operator takes priority.
Available since: 1.4
Parameters
str-
Type:
const char*The string specifying the condition.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string.
Return value
Type: AdwBreakpointCondition
The parsed condition.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |