Operator Type:
Operator Scope of Action:
Operator Purpose:
Operator First Added:
Operator Altered:
Function [other Function type actions]
Group [operators of similar scope]
Data manipulation [other Data manipulation operators]
9.0.0
9.1.0
neighborsWithin(item|group, N)
Returns a list of the path(s) of all those notes that can be reached by following between 1 and N links outward from the designated note or notes. Only the shortest possible path between two notes is considered.
The starting note or notes are considered to be connected to themselves.
For example:
$MyList = neighborsWithin(this, 3);
Returns the set of notes that are connected from this note by between 1–3 (outbound) links.
neighborsWithin(item|group, N, linkType)
Returns the set of notes that are connected by following bewteen 1 and N links outward from the designated note or notes, but considering only links of the specified link type linkType.
The starting note or notes are considered to be connected to themselves. To filter on unnamed links use the type "*untitled". For example:
$MyList = neighborsWithin(children, 2, "example");
Returns the set of notes that are connected from any of this note's children by by between 1–2 (outbound) links of the link type "example".
From v9.1.0, this operator now report links from the source node to itself, i.e. self-links (previously, these were ignored). Also, prototype-type links are now ignored.