This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon


In the context of DisplayExpressions and agents, 'that' refers to note running the code. As expressions like find() change the meaning of 'this', 'that' provides access to the original value of this. New in v5.10.0.

For instance, it makes it possible to to use an attribute value from the calling notes within a find() query in an expression. In such contexts, 'this' would apply to the note being queried by find() rather than the note calling find().

For example if Note A, has 'Note B' stored in $MyString and runs a rule (or some other action code) the following would fail to test each note in find() for a $MyString value of Note B:

find($MyString(this)=="Note B") Fail!


find($MyString(that)=="Note B") 

will test each note in scope of the find() query for the $MyString value stored in the calling note, i.e. Note A.

Designators don't allow offset references as with attributes. Thus $Name("Some note") works but child("Some note") doesn't. If an offset designator is needed use find() instead.

Possible relevant notes (via "Similar Notes" feature):

A Tinderbox Reference File : Objects & Concepts : Designators : Item Note Designators : that