This page is part of a static HTML representation of the TiddlyWiki at https://tiddlywiki.com/

Named Filter Run Prefix

11th July 2023 at 9:08am

In Introduced in v5.1.23 the named filter run prefixes were implemented. :cascade, :map and :sort have been added later as shown in the diagrams.

A named filter run prefix can precede any run of a filter expression in place of a shortcut run prefix.

:all:and:cascadev5.2.1:else:except:filter:intersection:mapv5.2.0:or:reduce:sortv5.2.0:letv5.4.0:thenv5.3.0run

Tip
Compare named filter run prefix :filter with filter Operator which applies a subfilter to every input title, removing the titles that return an empty result from the subfilter

Tip
Compare named filter run prefix :reduce with reduce Operator which is used to used to flatten a list of items down to a single item by repeatedly applying a subfilter

Tip
Within the filter runs prefixed with :reduce, :sort, :map and :filter, the currentTiddler variable is set to the title of the tiddler being processed.
The value of currentTiddler outside the subfilter is available in the variable ..currentTiddler Introduced in v5.2.0

Suffixes

Named filter run prefixes can accept suffixes separated by : characters, each optionally containing comma-separated values. The general syntax is :prefixname:suffix1:suffix2,.... Currently the following prefixes accept suffixes:

PrefixSuffixesExample
:mapflat — return all results instead of only the first per item:map:flat[...]
:sorttype (string, alphanumeric, number, integer, version, date) and flags (reverse, casesensitive, caseinsensitive):sort:number:reverse[...]

All other named prefixes (:all, :and, :cascade, :else, :except, :filter, :intersection, :let, :or, :reduce, :then) do not currently accept suffixes.

Also see: Interchangeable Filter Run Prefixes