yq/pkg/yqlib/doc/operators/omit.md

# Omit

Works like `pick`, but instead you specify the keys/indices that you _don't_ want included.

## Omit keys from map
Note that non existent keys are skipped.

Given a sample.yml file of:
```yaml
myMap:
  cat: meow
  dog: bark
  thing: hamster
  hamster: squeak
```
then
```bash
yq '.myMap |= omit(["hamster", "cat", "goat"])' sample.yml
```
will output
```yaml
myMap:
  dog: bark
  thing: hamster
```

## Omit indices from array
Note that non existent indices are skipped.

Given a sample.yml file of:
```yaml
- cat
- leopard
- lion
```
then
```bash
yq 'omit([2, 0, 734, -5])' sample.yml
```
will output
```yaml
- leopard
```