mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-06-27 07:43:14 +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>
64 lines
2.1 KiB
Plaintext
64 lines
2.1 KiB
Plaintext
caption: range
|
|
created: 20171221184734665
|
|
modified: 20230321133838310
|
|
op-input: ignored
|
|
op-neg-output: a series of evenly spaced numbers ranging from `<begin>` to `<end>` in reverse order
|
|
op-output: a series of evenly spaced numbers ranging from `<begin>` to `<end>`
|
|
op-parameter: a range specification, like `[1],[5]`
|
|
op-parameter-name: N
|
|
op-purpose: generate a range of numbers
|
|
tags: [[Filter Operators]] [[Negatable Operators]] [[Selection Constructors]]
|
|
title: range Operator
|
|
type: text/vnd.tiddlywiki
|
|
|
|
\define range_example(range)
|
|
```
|
|
[range[$range$]]
|
|
```
|
|
|
|
<$list variable=n filter="[range[$range$]]"><<n>> </$list>
|
|
\end
|
|
|
|
The `range` operator produces a list of numbers counting up or down. It is useful for counting and numbering.
|
|
|
|
<<.from-version "5.2.0">> The range operator has been updated to use multiple parameters. Prior to this version, the range operator only had one parameter, with the three parts delimited by `,`, `;` or `:`.
|
|
|
|
```
|
|
[range[<begin>]]
|
|
[range[<begin>],[<end>]]
|
|
[range[<begin>],[<end>],[<step>]]
|
|
```
|
|
|
|
The behaviour depends on the number of parameters:
|
|
|
|
|Parameter |Output |h
|
|
|`<end>` |Whole numbers up to `<end>` |
|
|
|`<begin>,<end>` |Numbers from `<begin>` to `<end>`, spaced by whole numbers |
|
|
|`<begin>,<end>,<step>` |Numbers from `<begin>` to `<end>` spaced out by `<step>` |
|
|
|
|
Each part must be a number, and works as follows:
|
|
|
|
* `<begin>`: start counting at this number.
|
|
** Defaults to 1 if `<end>` is at least 1 (or -1 if `<end>` is at most -1).
|
|
* `<end>`: stop counting at this number.
|
|
** This number will appear in the list unless it falls between two steps.
|
|
* `<step>`: count up (or down) by this amount.
|
|
** Defaults to 1.
|
|
** Cannot be zero.
|
|
** We always count from `<begin>` toward `<end>`, whether `<step>` is positive or negative.
|
|
|
|
The number of decimal points in the output is fixed, and based on the parameter with the //most// decimal points.
|
|
|
|
To prevent the browser from freezing, `range` is currently limited to 10,000 values.
|
|
|
|
!!Examples
|
|
|
|
<<range_example "7">>
|
|
|
|
<<range_example "1],[10">>
|
|
|
|
<<range_example "17],[13">>
|
|
|
|
<<range_example "1.001],[5],[1">>
|
|
|
|
<<range_example ".5],[1.4],[.004">> |