Tinderbox 8 Icon

create(item)


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Operator First Added: 

Operator Altered: 

 Function   [other Function type actions]

 Item   [operators of similar scope]

 Data manipulation   [other Data manipulation operators]

 Baseline

 


create(item)

creates a new note at the designated location, and returns the full path to that note. If the designated note already exists, no new note is created and the operator returns the empty string.

item is typically a complete path:

create("/hardware/taps") 

item can be a unique note name, in which case a new note is created as a child of the current note.

create("/hardware/taps") 

create(/path/to/container, name)

A two-argument variant is also offered that allows the container for a new item to be specified, and the new item's $Name. This may be useful if you need to create several notes in the same container, for example is iterating a list with .each(). For example:

create("/hardware","taps")