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]
Already in v5.0.0
inside("item")
Returns 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().
The item parameter must be quoted unless an attribute reference. Ways to define item.
Pertinent to map view, inside() and adornments:
- inside() is true for an note that is a child of the map's container
- inside() is true if a map note is on top of (within or overlapping) an adornment.
- inside() for a container does not match adornments.
In a more general context inside("X") is true for note A if any of the following are true:
- A is inside X
- an alias of A is inside X
- A is an alias, and its original is inside X
The last of these, if overlooked, can give unexpected results. The more expansive matching above is necessary to do things like looking inside agents. A better test to match just the first of the three conditions above is $Container=="X"
This operator replaced the deprecated legacy #inside query operator.