yq/operators/length.md

Length

Returns the lengths of the nodes. Length is defined according to the type of the node.

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

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

String length

returns length of string

Given a sample.yml file of:

a: cat

then

yq '.a | length' sample.yml

will output

3

null length

Given a sample.yml file of:

a: null

then

yq '.a | length' sample.yml

will output

0

Map length

returns number of entries

Given a sample.yml file of:

a: cat
c: dog

then

yq 'length' sample.yml

will output

2

Array length

returns number of elements

Given a sample.yml file of:

- 2
- 4
- 6
- 8

then

yq 'length' sample.yml

will output

4