mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-06-28 00:03:16 +00:00
a49436160d
* Improve Filter Syntax documentaion / navigation * update links and missing diagrams * rename legacy prefix to shortcut prefix * Update editions/tw5.com/tiddlers/filters/Filter Operators.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/And Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/Sort Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/Cascade Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * Update editions/tw5.com/tiddlers/filters/syntax/And Filter Run Prefix.tid Co-authored-by: yaisog <m@rcuswinter.de> * add most changes a suggested by yaisog * fix copy / paste from-version * replace operand with parameter in the docs * fix typo * fix typos and improve railroad diagrams consistency * move "new from version" info for filter run prefixes below the table * fix typo transclusion and substitution * Move Filters tiddler to the top level in the TOC * wip-breadcrumbs * breadcrumbs & breadcrumbsList macro final * remove files that do not belong to this PR * restore release banner * add simple / story mode to breadcrumbs * .breadcrumbs macro update comments * new breadcrumbs CSS, woks with small screens * make CSS configurable using hidden-settings * improve CSS fro small screens * remove the initial: recursiveParentTag macro * improve location info for breadcrumbs nav. add "alt-text" for Edge ::after element * breadcrumbs add mode=field * bc add initial docs * breadcrumbsField will also respect the story ordering * add configurable global filterMode setting * improve arrow CSS for browser zooming * add bc links use bc-caption if caption field is non-empty * breadcrumbs improve comments * breadcrumbs aria-lable uses caption if there is one * breadcrumbs improve documentation * breadcrumbs improve docs for sort param * fix showArrows docs * remove .bc-link aria-label .. it's not needed if caption is resolved properly * use subfilter instead of enlist to evaluate the "excluded" variable. Be consistent with toc-macros * remove breadcrumbs macros - they have their own PR now * resolve conflict * add back doc-macros tiddler * integrate :then filter run prefix * remove .breadcrumbs macros and their config tiddlers * fix typos as requested --------- Co-authored-by: yaisog <m@rcuswinter.de>
52 lines
1.8 KiB
Plaintext
52 lines
1.8 KiB
Plaintext
created: 20200412181551706
|
|
modified: 20200412181551706
|
|
tags: [[Filter Operators]] [[Mathematics Operators]] [[String Operators]] [[Negatable Operators]]
|
|
title: compare Operator
|
|
type: text/vnd.tiddlywiki
|
|
caption: compare
|
|
op-purpose: filter the input by comparing each item against the parameter
|
|
op-input: a [[selection of titles|Title Selection]]
|
|
op-suffix: the <<.op compare>> operator uses a rich suffix, see below for details
|
|
op-parameter: the value to compare
|
|
op-output: those input titles matching the specified comparison
|
|
op-neg-output: those input titles <<.em not>> matching the specified comparison
|
|
|
|
<<.from-version "5.1.22">>The <<.op compare>> filter allows numerical, string and date comparisons to be performed.
|
|
|
|
The <<.op compare>> operator uses an extended syntax to specify all the options:
|
|
|
|
```
|
|
[compare:<type>:<mode>[<parameter>]]
|
|
```
|
|
|
|
The ''type'' can be:
|
|
|
|
* "number" - invalid numbers are interpreted as zero
|
|
* "integer" - invalid integers are interpreted as zero
|
|
* "string"
|
|
* "date" - invalid dates are interpreted as 1st January 1970
|
|
* "version" - invalid versions are interpreted as "v0.0.0"
|
|
|
|
The ''mode'' can be:
|
|
|
|
* "eq" - equal to
|
|
* "ne" - not equal to
|
|
* "gteq" - greater than or equal to
|
|
* "gt" - greater than
|
|
* "lteq" - less than or equal to
|
|
* "lt" - less than
|
|
|
|
The operator compares each item in the selection against the value of the parameter, retaining only those items that pass the specified condition.
|
|
|
|
For example:
|
|
|
|
```
|
|
[[2]compare:number:eq[3]] returns nothing
|
|
[[2]compare:number:lt[3]] returns "2"
|
|
[[2]compare:number:eq[2]] returns "2"
|
|
```
|
|
|
|
Note that several of the variants of the <<.op compare>> operator are synonyms for existing operators, and are provided in the interests of consistency. For example, `compare:string:eq[x]` is a synonym for `match[x]`.
|
|
|
|
<<.operator-examples "compare">>
|