Function
AdwBreakpointConditionparse
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 |
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
| Returns: | AdwBreakpointCondition |
The parsed condition. |
|
| The caller of the function takes ownership of the data, and is responsible for freeing it. |