Operator Scope of Action:
Operator First Added:
This 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.
From v9.1.0, the create() operator always returns the path to the note. Previously, if the note already existed, create() returned false.
This function needs no left-side expression argument, i.e. '$SomeAttribute='.
item is typically a complete path:
item can be a unique note name, in which case a new note is created as a child of the current note. For example:
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:
Or, more pertinently, using a loop variable 'xPlace':
Essentially, the two-input form allows 3 forms of variation:
- different path, different name (via two nested loops—one for paths, one for names)
- different path, same name (loop with path variants)
- same path, different name (loop with name variants)
Designators and evaluation
From v9.1.0, paths like this are no longer evaluated, nor are designators:
Instead use code like this:
var path="/Resources/Test/"+$MyString; create(path);