yq/operators/line.md

Line

Returns the line of the matching node. Starts from 1, 0 indicates there was no line data.

{% hint style="warning" %} Note that versions prior to 4.18 require the 'eval/e' command to be specified.

yq e <exp> <file> {% endhint %}

Returns line of value node

Given a sample.yml file of:

a: cat
b:
  c: cat

then

yq '.b | line' sample.yml

will output

3

Returns line of key node

Pipe through the key operator to get the line of the key

Given a sample.yml file of:

a: cat
b:
  c: cat

then

yq '.b | key| line' sample.yml

will output

2

First line is 1

Given a sample.yml file of:

a: cat

then

yq '.a | line' sample.yml

will output

1

No line data is 0

Running

yq --null-input '{"a": "new entry"} | line'

will output

0