2018-07-19 20:42:09 +00:00
caption: range
2024-02-14 16:20:32 +00:00
created: 20171221184734665
modified: 20230321133838310
2018-07-19 20:42:09 +00:00
op-input: ignored
2024-02-14 16:20:32 +00:00
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>`
2021-09-07 16:16:09 +00:00
op-parameter: a range specification, like `[1],[5]`
2018-07-19 20:42:09 +00:00
op-parameter-name: N
2024-02-14 16:20:32 +00:00
op-purpose: generate a range of numbers
tags: [[Filter Operators]] [[Negatable Operators]] [[Selection Constructors]]
title: range Operator
type: text/vnd.tiddlywiki
2018-07-19 20:42:09 +00:00
\define range_example(range)
```
[range[$range$]]
```
<$list variable=n filter="[range[$range$]]"><<n>> </$list>
\end
2021-09-07 16:16:09 +00:00
The `range` operator produces a list of numbers counting up or down. It is useful for counting and numbering.
2018-07-19 20:42:09 +00:00
2024-02-14 16:20:32 +00:00
<<.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 `:`.
2018-07-19 20:42:09 +00:00
2021-09-07 16:16:09 +00:00
```
[range[<begin>]]
[range[<begin>],[<end>]]
[range[<begin>],[<end>],[<step>]]
```
2018-07-19 20:42:09 +00:00
2024-02-14 16:20:32 +00:00
The behaviour depends on the number of parameters:
2021-09-07 16:16:09 +00:00
|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>` |
2018-07-19 20:42:09 +00:00
Each part must be a number, and works as follows:
2018-12-02 08:39:28 +00:00
* `<begin>`: start counting at this number.
** Defaults to 1 if `<end>` is at least 1 (or -1 if `<end>` is at most -1).
2018-07-19 20:42:09 +00:00
* `<end>`: stop counting at this number.
2018-12-02 08:39:28 +00:00
** This number will appear in the list unless it falls between two steps.
2018-07-19 20:42:09 +00:00
* `<step>`: count up (or down) by this amount.
2018-12-02 08:39:28 +00:00
** Defaults to 1.
** Cannot be zero.
** We always count from `<begin>` toward `<end>`, whether `<step>` is positive or negative.
2018-07-19 20:42:09 +00:00
2024-02-14 16:20:32 +00:00
The number of decimal points in the output is fixed, and based on the parameter with the //most// decimal points.
2018-07-19 20:42:09 +00:00
To prevent the browser from freezing, `range` is currently limited to 10,000 values.
!!Examples
<<range_example "7">>
2021-09-07 16:16:09 +00:00
<<range_example "1],[10">>
2018-07-19 20:42:09 +00:00
2021-09-07 16:16:09 +00:00
<<range_example "17],[13">>
2018-07-19 20:42:09 +00:00
2021-09-07 16:16:09 +00:00
<<range_example "1.001],[5],[1">>
2018-07-19 20:42:09 +00:00
2021-09-07 16:16:09 +00:00
<<range_example ".5],[1.4],[.004">>
