Tinderbox 8 Icon

delete(item)


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]

 Baseline

 8.7.0


delete(item)

Deletes the designated item note; from v8.7.0 the scope is group (or item). If the designated note does not exist, the expression has no effect and returns false, i.e. nothing happens: no deletion, no message of no deletion. If the designated note exists, it will be deleted and the expression returns its former path.

delete("Some note"); 

However, it is strongly suggesting using a path ($Path) for item and not just the note's title ($Name), thus:

delete("/The/path/to/Some note"); 

Avoid using this operator when possible. It can automatically delete notes you intended to create, and it can potentially saw off the branch you are standing on. In almost all circumstances, it is better to move the unwanted note to a container, and then to delete the note manually if you really need to delete it at all.

From v8.7.0, the delete() operator returns true if at least one note was deleted, and false otherwise.