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

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

<$macrocall $name=".operator-def"
input="a [[selection of titles|Title Selection]]"
suffix="the name of a [[field|TiddlerFields]]"
suffixName="f"
parameter="a possible value of field <<.place f>>"
paramName="s"
output="those input tiddlers in which field <<.place f>> has the value <<.place s>>"
negationOutput="those input tiddlers in which field <<.place f>> does <<.em not>> have the value <<.place s>>"
/>

If <<.place s>> 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

The syntax of a [[filter step|Filter Step]] treats any unrecognised [[filter operator|Filter Operators]] as if it was the suffix to the <<.op field>> operator. See the <<.operator-examples "field" "examples">>.

<<.operator-examples "field">>
Update tiddler filter docs 2014-04-10 18:56:51 +00:00			`created: 20140410103123179`
Overhaul the filter operator documentation: part 2 2015-01-24 21:18:44 +00:00			`modified: 20150124201655000`
			`tags: [[Filter Operators]] [[Common Operators]] [[Field Operators]] [[Negatable Operators]]`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`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`
Overhaul the filter operator documentation: part 2 2015-01-24 21:18:44 +00:00			`purpose: filter the input by field`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00
Overhaul the filter operator documentation: part 2 2015-01-24 21:18:44 +00:00			`<$macrocall $name=".operator-def"`
			`input="a [[selection of titles\|Title Selection]]"`
			`suffix="the name of a [[field\|TiddlerFields]]"`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`suffixName="f"`
Overhaul the filter operator documentation: part 2 2015-01-24 21:18:44 +00:00			`parameter="a possible value of field <<.place f>>"`
			`paramName="s"`
			`output="those input tiddlers in which field <<.place f>> has the value <<.place s>>"`
			`negationOutput="those input tiddlers in which field <<.place f>> does <<.em not>> have the value <<.place s>>"`
Overhaul the filter operator documentation: part 1 2015-01-18 18:39:00 +00:00			`/>`

Overhaul the filter operator documentation: part 2 2015-01-24 21:18:44 +00:00			`If <<.place s>> 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 2 2015-01-24 21:18:44 +00:00			`The syntax of a [[filter step\|Filter Step]] treats any unrecognised [[filter operator\|Filter Operators]] as if it was the suffix to the <<.op field>> operator. See the <<.operator-examples "field" "examples">>.`
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">>`