This version is out of date, covering development from v9.0.0 to v9.3.0. It is maintained here only for inbound reference links from elsewhere. It is no longer actively updated.

Jump to the current version of aTbRef

Tinderbox v9 Icon


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Operator First Added: 

Operator Altered: 

 Function   [other Function type actions]

 Item   [operators of similar scope]

 Query Boolean   [other Query Boolean operators]




Returns Boolean true if the current note is a direct child of item or, put conversely, if item is the parent of the note. Thus it can be thought of as an "is a child of" operator and as such a counterpart to the "is parent of" operator contains(). Note that aliases can be matched by inside(), which may appear counter-intuitive at first encounter: if only wanting to match original notes, see section 'Filtering out aliases' below.

The item parameter must be quoted unless an attribute reference. Ways to define item.

Pertinent to map view, inside() and adornments:

In a more general context inside("X") is true for note A if any of the following are true:

The last of these, if overlooked, can give unexpected results. The more expansive matching above is necessary to do things like looking inside agents.

If more than one container matching item is present, inside() returns items matching the first such container as listed in $OutlineOrder. If deliberately wanting to match notes inside any of several same-named containers, e.g. "exploded notes", then use $Name(parent)=="container name" instead.

Filtering out aliases

To match only originals, i.e. just the first of the three conditions in the previous list above, use inside("X") & $IsAlias==false.

This operator replaced the deprecated legacy #inside query operator.