logical-condition(cnd a, val b [, c, ...])

Group

Logical Functions


This function is deprecated.

Returns the Boolean value true or false depending on the condition in parameter a and its parameter b and possibly (depending on the condition) b, c, … (see table). The condition is expected as keyword (e.g. equal), to negate the condition it can be preceded by not, e.g. not equal or notequal. The number of parameters starting with b is depending on the actual condition. The remaining parameters are ignored.

The function itself does not implement the logic behind the condition but is calling the corresponding functions. The return value is the result of the called function.

In addition to logical conditions, macros can be called with syntax Macro(Macroname) in parameter a. If the keyword is not supported, the function terminates with an error message.

Condition values in parameter a

Value

Used Function

empty

is empty(a)

match

match-pattern(a, b)

file

file-exists(a)

length

length(trim(a)) > 0

equal

a equals b

istrue

copy(field/value/variable)

and

logical-and(a, b,[c,d,e])

or

logical-or(a, b,[c,d,e])

xor

xor(a, b)

numeric

numeric(a)

<

a < b

>

a > b

<=

a <= b

>=

a >= b

If not is preceding the condition name, the result of the called function will be negated.

Extending the Registered Condition Keywords

In addition to the hardcoded keywords as they are shown in above table, it is possible to add other keywords by adding these to the file ./etc/admin/datawizard/custom_conditionfilter.properties. The file is read in during the startup of Lobster_data and after each change of the file. Syntax:

<key>=<function ID> or

<key>=<function class name> or

<key>=Macro(Macroname)


The keys must be unique and the class name must be fully qualified including the package. Function IDs are registered IDs from the file filter.properties or custom_filter.properties (positive numbers). Macros are only loaded when used the first time. Public macros are available for every client, client-specific macros only for their corresponding client.

If a function needs more than five parameters, the number of parameters must be explicitly set with the property param_count=parametercount. Values smaller than 6 are ignored.

Registered keys are shown as tooltip of parameter a, registered public macros only after their first use.

Description of Parameters

Parameter

Description

a

Name of the condition to be used.

b

Argument.

c, ...

Additional arguments (dependent on the used condition).

Examples

Parameter a

Parameter b

Parameter c

Result

not numeric

M73D22

true

equal

one

two

false