yq/pkg/yqlib/doc/Delete.md

Deletes matching entries in maps or arrays.

Delete entry in map

Given a sample.yml file of:

a: cat
b: dog
'': null

then

yq eval 'del(.b)' sample.yml

will output

a: cat
'': null

Delete nested entry in map

Given a sample.yml file of:

a: {a1: fred, a2: frood}
'': null

then

yq eval 'del(.a.a1)' sample.yml

will output

a: {a2: frood}
'': null

Delete entry in array

Given a sample.yml file of:

- 1
- 2
- 3

then

yq eval 'del(.[1])' sample.yml

will output

- 1
- 3

Delete nested entry in array

Given a sample.yml file of:

- a: cat
  b: dog
  '': null

then

yq eval 'del(.[0].a)' sample.yml

will output

- b: dog
  '': null

Delete no matches

Given a sample.yml file of:

a: cat
b: dog
'': null

then

yq eval 'del(.c)' sample.yml

will output

a: cat
b: dog
'': null

Delete matching entries

Given a sample.yml file of:

a: cat
b: dog
c: bat
'': null

then

yq eval 'del( .[] | select(. == "*at") )' sample.yml

will output

b: dog
'': null