vrl 0.38.0

Vector Remap Language
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

{
  "anchor": "range",
  "name": "range",
  "category": "Array",
  "description": "Returns an array of integers from `start` (inclusive) to `end` (exclusive), incremented by `step`.",
  "arguments": [
    {
      "name": "start",
      "description": "The first value of the range.",
      "required": true,
      "type": [
        "integer"
      ]
    },
    {
      "name": "end",
      "description": "The end of the range. This value is not included in the result.",
      "required": true,
      "type": [
        "integer"
      ]
    },
    {
      "name": "step",
      "description": "The increment between values. Can be negative, but not zero.",
      "required": false,
      "type": [
        "integer"
      ],
      "default": "1"
    }
  ],
  "return": {
    "types": [
      "array"
    ]
  },
  "internal_failure_reasons": [
    "`step` is zero.",
    "The resulting array would have more than 100,000 elements."
  ],
  "examples": [
    {
      "title": "Generate a range of integers",
      "source": "range!(500, 505)",
      "return": [
        500,
        501,
        502,
        503,
        504
      ]
    },
    {
      "title": "Generate a range with a step",
      "source": "range!(0, 10, 3)",
      "return": [
        0,
        3,
        6,
        9
      ]
    },
    {
      "title": "Generate a decreasing range",
      "source": "range!(5, 0, -1)",
      "return": [
        5,
        4,
        3,
        2,
        1
      ]
    },
    {
      "title": "Expand a range expressed as a string",
      "source": "bounds = split(\"1..4\", \"..\"); range!(to_int!(bounds[0]), to_int!(bounds[1]) + 1)",
      "return": [
        1,
        2,
        3,
        4
      ]
    }
  ],
  "pure": true
}