yq/pkg/yqlib/doc/headers/Recursive Descent.md

19 lines
859 B
Markdown
Raw Normal View History

2021-01-08 00:59:49 +00:00
This operator recursively matches (or globs) all children nodes given of a particular element, including that node itself. This is most often used to apply a filter recursively against all matches. It can be used in either the
2020-12-28 00:24:42 +00:00
## match values form `..`
This will, like the `jq` equivalent, recursively match all _value_ nodes. Use it to find/manipulate particular values.
For instance to set the `style` of all _value_ nodes in a yaml doc, excluding map keys:
2020-11-17 22:44:16 +00:00
```bash
yq eval '.. style= "flow"' file.yaml
2020-12-28 00:24:42 +00:00
```
## match values and map keys form `...`
The also includes map keys in the results set. This is particularly useful in YAML as unlike JSON, map keys can have their own styling, tags and use anchors and aliases.
For instance to set the `style` of all nodes in a yaml doc, including the map keys:
```bash
yq eval '... style= "flow"' file.yaml
2020-11-17 22:44:16 +00:00
```