mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-08-23 10:06:44 +00:00
19 lines
1.4 KiB
Plaintext
19 lines
1.4 KiB
Plaintext
created: 20210618133745003
|
|
modified: 20210618134747652
|
|
tags: [[Filter Syntax]] [[Filter Run Prefix]]
|
|
title: Map Filter Run Prefix
|
|
type: text/vnd.tiddlywiki
|
|
|
|
<<.from-version "5.2.0">>
|
|
|
|
|''purpose'' |modify input titles by the result of evaluating this filter run for each item |
|
|
|''input'' |all titles from previous filter runs |
|
|
|''output''|the input titles as modified by the result of this filter run |
|
|
|
|
Each input title from previous runs is passed to this run in turn. The filter run transforms the input titles and the output of this run replaces the input title. For example, the filter run `[get[caption]else{!!title}]` replaces each input title with its caption field, unless the field does not exist in which case the title is preserved.
|
|
|
|
Note that within the filter run, the "currentTiddler" variable is set to the title of the tiddler being processed. This permits filter runs like `:map[{!!price}multiply{!!cost}]` to be used for computation. The value of currentTiddler outside the run is available in the variable "..currentTiddler".
|
|
|
|
Filter runs used with the `:map` prefix should return the same number of items that they are passed. Any missing entries will be treated as an empty string. In particular, when retrieving the value of a field with the [[get Operator]] it is helpful to guard against a missing field value using the [[else Operator]]. For example `[get[myfield]else[default-value]...`.
|
|
|
|
[[Examples|Map Filter Run Prefix (Examples)]] |