linkedTo("item"[,linkType])

Tinderbox Icon


Operator Type:   Function
Operator Scope of Action:   Item
Operator Purpose:   Boolean (query)

linkTo("item"[,linkType])

Returns true if the current note links to item; this is optionally filtered to only links of type linkType. The item parameter must be quoted unless it is an attribute reference, e.g. "Some note" vs $MyString. Scope is a single note only. Links of type 'prototype' are ignored. Used in an agent, 'this' note is the alias in the agent and not its original, making this action unsuitable for testing in a agent action.

From v5.8.0, as an exception to the operator's normal item-scope, a wildcard "*" designator is allowed which matches all notes. From 5.9.0, item may be group scoped including use of group designators and operators like find(), collect and links().

If using linkType, you must use the value "*untitled" to match an 'untitled' type link (rather than "" or "untitled").

In the query creation pop-ups of agent and Find dialogs this function is listed as "linked to".

This replaces the legacy #linkedTo query operator.

The logical opposite if this test is linkedFrom().

From v5.9.0 this function can target an alias as opposed to an original (if the logical choice) and can accept a group scope.


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

Up: Full Operator List
Previous: linkedFrom("item"[,linkType])  Next: linkFrom("item"[,linkType]) 

A Tinderbox Reference File : Actions & Rules : Operators : Full Operator List : linkedTo("item"[,linkType])

Quicklinks: Attributes | Action Codes | Export Codes | Designators | Date Formats | aTbRef Site Map

[Last updated: 16 May 2012, using v5.11.1]


Search:

Google search aTbRef for:  


Creative Commons Licence

aTbRef by Mark Anderson is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.

[See aTbRef CC licence Attribution & Waiver info]

Made with Tinderbox