Operator Type:
Operator Scope of Action:
Operator Purpose:
Data Type Returned:
Operator First Added:
Operator in Current Baseline:
Operator Last Altered:
Operator [other Operator type actions]
Item [operators of similar scope]
Query Boolean [other Query Boolean operators]
boolean test
v4.6.0
Baseline
As at baseline
(!$AttributeName)
In queries and conditional action code expressions, preceding a '$'-prefixed attribute name with an exclamation mark functions as a shortened form of the Boolean test for a false value. Due to limitations in the underlying parser, an inequality test expression must be enclosed in parentheses.Thus the following are functional equivalents:
$MyBoolean==false
(!$MyBoolean)
Do not use this form or you may get unexpected results:
!$MyBoolean Do not use this format, without parentheses!
In both cases the result is false if the value of $MyBoolean is false.
Usefully Tinderbox also useful supports such short-form !$AttributeName tests for all the other attribute data types, returning true if the attribute has a default value. Per data type, this equates to long form tests like:
$MyBoolean==false
$MyColor==""
$MyDate=="never"
$MyDictionary==""
$MyFile==""
$MyInterval=="00:00"
$MyList==[] (or (deprecated) $MyList=="")
$MyNumber==0
$MySet==[] (or (deprecated) $MyList=="")
$MyString==""
$MyURL==""
This also holds for system-only data types:
$MyAction==""
$MyFont==""
In all these cases a short-form test returns true if the attribute value is the default for that data type.
This test is the logical opposite of the $AttributeName test.
See also—notes linking to here: