yq/pkg/yqlib/doc/Alternative (Default value).md

This operator is used to provide alternative (or default) values when a particular expression is either null or false.

## LHS is defined
Given a sample.yml file of:
```yaml
a: bridge
'': null
```
then
```bash
yq eval '.a // "hello"' sample.yml
```
will output
```yaml
bridge
```

## LHS is not defined
Given a sample.yml file of:
```yaml
{}
```
then
```bash
yq eval '.a // "hello"' sample.yml
```
will output
```yaml
hello
```

## LHS is null
Given a sample.yml file of:
```yaml
a: ~
'': null
```
then
```bash
yq eval '.a // "hello"' sample.yml
```
will output
```yaml
hello
```

## LHS is false
Given a sample.yml file of:
```yaml
a: false
'': null
```
then
```bash
yq eval '.a // "hello"' sample.yml
```
will output
```yaml
hello
```

## RHS is an expression
Given a sample.yml file of:
```yaml
a: false
b: cat
'': null
```
then
```bash
yq eval '.a // .b' sample.yml
```
will output
```yaml
cat
```