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

created: 20140410103123179
modified: 20150119192437000
tags: [[Filter Operators]] [[Common Operators]] [[Field Operators]]
title: field Operator
type: text/vnd.tiddlywiki
caption: field
purpose: filter the input tiddlers by field value

<$macrocall $name=".operator-def-suffix"
input="a [[title selection|Title Selections]]"
suffix="the name of a field"
suffixName="f"
parameter="a potential value for field <<.place f>>"
paramName="p"
output="the [[subselection|Title Selections]] of the input tiddlers in which field <<.place f>> has the value <<.place p>>"
/>

If <<.place p>> is empty, <<.op field>> will match both of the following:

* tiddlers that don't contain field <<.place f>>
* tiddlers in which field <<.place f>> exists but has an empty value

;Negation
: `!field` outputs the subselection of the input tiddlers in which field <<.place f>> does <<.em not>> have the value <<.place p>>.

The [[Filter Syntax]] treats any unrecognised [[filter operator|Filter Operators]] as if it was the suffix to the <<.olink field>> operator. See the second example below.

<<.operator-examples "field">>
Update tiddler filter docs 2014-04-10 18:56:51 +00:00			`created: 20140410103123179`
Revise terminology around tiddler sets 2015-01-19 19:37:26 +00:00			`modified: 20150119192437000`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`tags: [[Filter Operators]] [[Common Operators]] [[Field Operators]]`
			`title: field 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: field`
			`purpose: filter the input tiddlers by field value`

			`<$macrocall $name=".operator-def-suffix"`
Revise terminology around tiddler sets 2015-01-19 19:37:26 +00:00			`input="a [[title selection\|Title Selections]]"`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`suffix="the name of a field"`
			`suffixName="f"`
			`parameter="a potential value for field <<.place f>>"`
			`paramName="p"`
Revise terminology around tiddler sets 2015-01-19 19:37:26 +00:00			`output="the [[subselection\|Title Selections]] of the input tiddlers in which field <<.place f>> has the value <<.place p>>"`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`/>`

			`If <<.place p>> is empty, <<.op field>> will match both of the following:`
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			`* tiddlers that don't contain field <<.place f>>`
			`* tiddlers in which field <<.place f>> exists but has an empty value`
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			`;Negation`
Revise terminology around tiddler sets 2015-01-19 19:37:26 +00:00			: `!field` outputs the subselection of the input tiddlers in which field <<.place f>> does <<.em not>> have the value <<.place p>>.
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			`The [[Filter Syntax]] treats any unrecognised [[filter operator\|Filter Operators]] as if it was the suffix to the <<.olink field>> operator. See the second example below.`
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 "field">>`