TiddlyWiki5/editions/tw5.com/tiddlers/filters/each.tid

created: 20140410103123179
modified: 20150127202915000
tags: [[Filter Operators]] [[Group Operators]]
title: each Operator
type: text/vnd.tiddlywiki
caption: each
purpose: select one of each group of input titles by field

<$macrocall $name=".operator-def"
input="a [[selection of titles|Title Selection]]"
suffix="optionally, `list`"
parameter="the name of a [[field|TiddlerFields]], defaulting to <<.field title>>"
paramName="f"
output="a selection containing the first input title encountered for each distinct value of field <<.place f>>"
/>

Each input title is processed in turn. The value of field <<.place f>> in the corresponding tiddler is examined.

;each
:As long as the field's value has not been encountered before, the title is appended to the output.
;each:list
:The value is treated as a [[title list|Title List]]. Each title in the list considered in turn. If it has not been encountered before, it is appended to the output.

If a tiddler doesn't contain field <<.place f>>, it is treated as if the field's value was empty.

<<.operator-examples "each">>
Update tiddler filter docs 2014-04-10 18:56:51 +00:00			`created: 20140410103123179`
Adjust documentation following pull #1422 2015-01-27 20:38:30 +00:00			`modified: 20150127202915000`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`tags: [[Filter Operators]] [[Group Operators]]`
			`title: each Operator`
Update tiddler filter docs 2014-04-10 18:56:51 +00:00			`type: text/vnd.tiddlywiki`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`caption: each`
Overhaul the filter operator documentation: part 2 2015-01-24 21:18:44 +00:00			`purpose: select one of each group of input titles by field`
Update tiddler filter docs 2014-04-10 18:56:51 +00:00
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`<$macrocall $name=".operator-def"`
Overhaul the filter operator documentation: part 2 2015-01-24 21:18:44 +00:00			`input="a [[selection of titles\|Title Selection]]"`
Adjust documentation following pull #1422 2015-01-27 20:38:30 +00:00			suffix="optionally, `list`"
			`parameter="the name of a [[field\|TiddlerFields]], defaulting to <<.field title>>"`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`paramName="f"`
Overhaul the filter operator documentation: part 2 2015-01-24 21:18:44 +00:00			`output="a selection containing the first input title encountered for each distinct value of field <<.place f>>"`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`/>`
Update tiddler filter docs 2014-04-10 18:56:51 +00:00
Adjust documentation following pull #1422 2015-01-27 20:38:30 +00:00			`Each input title is processed in turn. The value of field <<.place f>> in the corresponding tiddler is examined.`
Overhaul the filter operator documentation: part 2 2015-01-24 21:18:44 +00:00
Adjust documentation following pull #1422 2015-01-27 20:38:30 +00:00			`;each`
			`:As long as the field's value has not been encountered before, the title is appended to the output.`
			`;each:list`
			`:The value is treated as a [[title list\|Title List]]. Each title in the list considered in turn. If it has not been encountered before, it is appended to the output.`

			`If a tiddler doesn't contain field <<.place f>>, it is treated as if the field's value was empty.`
Update tiddler filter docs 2014-04-10 18:56:51 +00:00
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`<<.operator-examples "each">>`