yq/pkg/yqlib/doc/Select Operator.md
Mike Farah dcacad1e7e docs
2020-11-18 10:32:30 +11:00

40 lines
542 B
Markdown

Select is used to filter arrays and maps by a boolean expression.
## Examples
### Select elements from array
Given a sample.yml file of:
```yaml
- cat
- goat
- dog
```
then
```bash
yq eval '.[] | select(. == "*at")' sample.yml
```
will output
```yaml
cat
goat
```
### Select and update matching values in map
Given a sample.yml file of:
```yaml
a:
things: cat
bob: goat
horse: dog
```
then
```bash
yq eval '(.a[] | select(. == "*at")) |= "rabbit"' sample.yml
```
will output
```yaml
a:
things: rabbit
bob: rabbit
horse: dog
```