vrl 0.32.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

{
  "anchor": "dirname",
  "name": "dirname",
  "category": "String",
  "description": "Returns the directory component of the given `path`. This is similar to the Unix `dirname` command. The directory component is the path with the final component removed.",
  "arguments": [
    {
      "name": "value",
      "description": "The path from which to extract the directory name.",
      "required": true,
      "type": [
        "string"
      ]
    }
  ],
  "return": {
    "types": [
      "string"
    ]
  },
  "internal_failure_reasons": [
    "`value` is not a valid string."
  ],
  "examples": [
    {
      "title": "Extract dirname from file path",
      "source": "dirname!(\"/usr/local/bin/vrl\")",
      "return": "/usr/local/bin"
    },
    {
      "title": "Extract dirname from file path with extension",
      "source": "dirname!(\"/home/user/file.txt\")",
      "return": "/home/user"
    },
    {
      "title": "Extract dirname from directory path",
      "source": "dirname!(\"/home/user/\")",
      "return": "/home"
    },
    {
      "title": "Root directory dirname is itself",
      "source": "dirname!(\"/\")",
      "return": "/"
    },
    {
      "title": "Relative files have current directory as dirname",
      "source": "dirname!(\"file.txt\")",
      "return": "."
    }
  ],
  "pure": true
}