yq/pkg/yqlib/doc/Equals.md

96 lines
1012 B
Markdown
Raw Normal View History

2020-11-17 22:44:16 +00:00
This is a boolean operator that will return ```true``` if the LHS is equal to the RHS and ``false`` otherwise.
```
.a == .b
```
It is most often used with the select operator to find particular nodes:
```
select(.a == .b)
```
2020-11-22 02:16:54 +00:00
## Match string
2020-11-17 22:44:16 +00:00
Given a sample.yml file of:
```yaml
- cat
- goat
- dog
```
then
```bash
yq eval '.[] | (. == "*at")' sample.yml
```
will output
```yaml
true
true
false
```
2021-02-04 22:54:03 +00:00
## Don't match string
Given a sample.yml file of:
```yaml
- cat
- goat
- dog
```
then
```bash
yq eval '.[] | (. != "*at")' sample.yml
```
will output
```yaml
false
false
true
```
2020-11-22 02:16:54 +00:00
## Match number
2020-11-17 22:44:16 +00:00
Given a sample.yml file of:
```yaml
- 3
- 4
- 5
```
then
```bash
yq eval '.[] | (. == 4)' sample.yml
```
will output
```yaml
false
true
false
```
2021-02-04 22:54:03 +00:00
## Dont match number
Given a sample.yml file of:
```yaml
- 3
- 4
- 5
```
then
```bash
yq eval '.[] | (. != 4)' sample.yml
```
will output
```yaml
true
false
true
```
2020-11-22 02:16:54 +00:00
## Match nulls
2020-11-17 22:44:16 +00:00
Running
```bash
yq eval --null-input 'null == ~'
```
will output
```yaml
true
```