This version is out of date, covering development from v8.0.0 to v8.x.x. 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 v8 Icon

unlinkFrom(["item|group"][,"linkType"])


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Operator First Added: 

Operator Altered: 

 Function   [other Function type actions]

 Group   [operators of similar scope]

 Linking   [other Linking operators]

 Baseline

 


unlinkFrom(["item|group"][,"linkType"])

This removes all basic links from item to the current note (i.e. inbound links).

The item parameter must be quoted unless an attribute reference, e.g. "Some note" vs $MyString. Ways to define item. Note that here, unlike other item uses, $Path can not be used.

item may be group scoped including use of group designators and operators like find,() collect and links().

linkType (string). Optionally, link deletion can be constrained to one or more types supplied in linkType. The argument allows simple regular expressions; "disagree|example" would delete links of type 'disagree' and 'example' but leave others untouched. If no linkType argument is supplied, only untitled (i.e. no link type) links are deleted. To delete all links of any type of none use "*".

Both arguments are evaluated. This operator does not require a left-side argument, simply calling effects a result. No change occurs if the described link does not exist.

Examples

Unlinking a note "Some note":

all link types: unlinkFrom("Some note", "*"); 

only link type 'agree': unlinkFrom("Some note","agree"); 

either of 2 link types: unlinkFrom("Some note", "example|disagree"); 

Unlinking the first child

unlinkFrom("child"); 

unlinkFrom("child","agree"); 

See further below for group-scope references.

Relevant similar operators: linkTo, linkFrom, unlinkTo.

Use of this action does not shift note focus; in addition if item contains operators (brackets, plus, minus, etc.) Tinderbox will first look for a match to the literal item string and only if there is no match will the app try evaluating to operators and testing the resulting string. For example:

unlinkFrom("Example 1 (a test)"); 

will unlink the note named 'Example 1 (a test)'. If no note matches this string, Tinderbox will attempt to evaluate the string. Thus for:

unlinkFrom("2+2"); 

will unlink the note named '2+2' but if there is no match Tinderbox will look for a note named '4'.

This function can unlink an alias as opposed to an original (if the logical choice) and can also accept a group scope. An example of group scope is the following code that could be used in a rule or stamp to remove in/bound footnote links from one or more selected notes. Use of the 'all' designator removes the need to know the name of the notes for which the selection are footnotes:

unlinkFrom(all,"note");unlinkTo(all,"note+"); 

Use in agents

Beware that the action is working on an alias of the current note and note the current note itself. As originals and aliases support discrete basic links this function should not generally be used in an agent. The best way to use the function is by using a prototype and apply a $Rule to it thus running the code in all notes using the prototype.

An alternative unlinkFromOriginal() code will ensure any link deleted is between two original notes regardless of whether an alias is the context of execution of the code.



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