jqの使い方を覚えるために実際サンプルコードを書いてみる。

オフィシャルマニュアルとちょっと表記が違うので注意。(各フィルタタイトルに「.」をつけてない。)

フィルタ別のサンプルコード

〈入力〉.〈出力〉

標準入力、または左側のJSONをそのまま出力する（と理解している)。

例

echo '{"john": "paul"}' | jq '.'
{
  "john": "paul"
}

〈入力〉[]〈出力〉

入力したJSONから外側の[]を外して出力する。
入力したJSONの配列から要素を取り出す。

例

$ echo '[40,74,58]' | jq '.[]'
40
74
58

入力したJSONから外側の{}を外して出力する。
入力したJSONのハッシュから要素の値を取り出す。キーは捨てる。

例

$ echo '{ "john":{"name": "John"}, "paul":{"name": "Paul"}}' \
 | jq '.[]'
{
  "name": "John"
}
{
  "name": "Paul"
}

$ echo '{ "john":{"name": "John"}, "paul":{"name": "Paul"}}' \
 | jq '.[][]'
"John"
"Paul"

[〈入力〉]〈出力〉

入力した値の外側に[]をつけて出力する。
新しい配列を作り、入力した値を配列の要素とする。

例1

$ echo '{"john": 40, "paul": 74}' | jq '[.]'
[
  {
    "john": 40,
    "paul": 74
  }
]

例2

$ echo '{"john": 40, "paul": 74}' | jq '.[]'
40
74

$ echo '{"john": 40, "paul": 74}' | jq '[.[]]'
[
  40,
  74
]

例3

$ echo '[74, 58]' | jq '[40, .[], 76]'
[
  40,
  74,
  58,
  76
]

〈入力〉["〈キー名〉"]〈出力〉

入力したJSONから指定されたキーを持つ要素の値を出力する。該当要素がなければnullを出力する。

例1

$ echo '{"john": { "name": "John", "old": 40}, \
 "paul": { "name": "Paul", "old": 74}}' \
 | jq '.["john"]'
{
  "name": "John",
  "old": 40
}

$ echo '{"john": { "name": "John", "old": 40}, \
 "paul": { "name": "Paul", "old": 74}}' \
 | jq '.["john"]["old"]'
40

例2

$ echo '{"john": { "name": "John", "old": 40}, \
 "paul": { "name": "Paul", "old": 74}}' \
 | jq '.[]["name"]'
"John"
"Paul"

〈入力〉.〈キー名〉〈出力〉

〈入力〉["〈キー名〉"]〈出力〉と同じ。

例1

$ echo '{"john": { "name": "John", "old": 40}, \
 "paul": { "name": "Paul", "old": 74}}' \
 | jq '.john'
{
  "name": "John",
  "old": 40
}

$ echo '{"john": { "name": "John", "old": 40}, \
 "paul": { "name": "Paul", "old": 74}}' \
 | jq '.john.old'
40

例2

$ echo '{"john": { "name": "John", "old": 40}, \
 "paul": { "name": "Paul", "old": 74}}' \
 | jq '.[].name'
"John"
"Paul"

{〈入力〉}〈出力〉

入力したキー名、値の外側に{}をつけて出力する。
新しいオブジェクトを作り、入力したキー名、値を要素とする。

例

$ echo '{"part":"Vocal"}' | jq '{"john": .[]}'
{
  "john": "Vocal"
}

キーと値がそれぞれ配列の場合、その要素の組み合わせ分だけオブジェクトを作成するのが面白い。

例1

$ echo '{"names":["John","Paul"]}' | jq '{"vocal": .names[]}'
{
  "vocal": "John"
}
{
  "vocal": "Paul"
}

例2

$ echo '{"names": ["John","Paul", "George"], \
 "parts":["Vocal","Base"]}' \
 | jq '{(.names[]): .parts[]}'
{
  "John": "Vocal"
}
{
  "John": "Base"
}
{
  "Paul": "Vocal"
}
{
  "Paul": "Base"
}
{
  "George": "Vocal"
}
{
  "George": "Base"
}

「(.names[])」の「()」は、書いておかないと展開してくれないらしい。

〈入力〉[〈インデックス〉]〈出力〉

入力したJSONの配列からインデックスの要素を取り出して出力する。

例

echo '[40, 74, 58, 76]' | jq '.[0]'
40

$ echo '[40, 74, 58, 76]' | jq '.[1]'
74

$ echo '[40, 74, 58, 76]' | jq '.[2]'
58

$ echo '[40, 74, 58, 76]' | jq '.[3]'
76

負の値を指定すると配列の末尾から探す。

例

$ echo '[40, 74, 58, 76]' | jq '.[-1]'
76

$ echo '[40, 74, 58, 76]' | jq '.[-2]'
58

$ echo '[40, 74, 58, 76]' | jq '.[-3]'
74

$ echo '[40, 74, 58, 76]' | jq '.[-4]'
40

〈入力〉[〈インデックス1〉:〈インデックス2〉]〈出力〉

入力したJSONの配列からインデックス1以上、インデックス2未満の要素を取り出して出力する。

例

$ echo '[40, 74, 58, 76]' | jq '.[1:2]'
[
  74
]

$ echo '[40, 74, 58, 76]' | jq '.[1:3]'
[
  74,
  58
]

インデックス1を省略すると開始インデックスが先頭になる。

例

$ echo '[40, 74, 58, 76]' | jq '.[:1]'
[
  40
]

$ echo '[40, 74, 58, 76]' | jq '.[:2]'
[
  40,
  74
]

$ echo '[40, 74, 58, 76]' | jq '.[:3]'
[
  40,
  74,
  58
]

インデックス2を省略すると終了インデックスが末尾になる。

例

$ echo '[40, 74, 58, 76]' | jq '.[1:]'
[
  74,
  58,
  76
]

$ echo '[40, 74, 58, 76]' | jq '.[2:]'
[
  58,
  76
]

インデックス1、インデックス2共に負の値をして可能。(どうなるかはめんどくさいから調べない。)

〈フィルタ1〉,〈フィルタ2〉

複数のフィルタの結果を連結して出力する。

例2

echo '{"john": { "name": "John", "old": 40}, \
 "paul": { "name": "Paul", "old": 74}}' \
 | jq '.[].name,.[].old'
"John"
"Paul"
40
74

$ echo '{"john": { "name": "John", "old": 40}, \
 "paul": { "name": "Paul", "old": 74}}' \
 | jq '[.[].name],[.[].old]'
[
  "John",
  "Paul"
]
[
  40,
  74
]

$ echo '{"john": { "name": "John", "old": 40}, \
 "paul": { "name": "Paul", "old": 74}}' \
 | jq '[.[].name,.[].old]'
[
  "John",
  "Paul",
  40,
  74
]

〈フィルタ1〉|〈フィルタ2〉

フィルタの結果にフィルタをかける。
フィルタ2にはフィルタ1の結果を受ける「.」が必要となる（と理解している。)
フィルタ1の結果が複数箇所必要になる時に使うっぽい。

例

$ echo '{"john": { "name": "John", "old": 40}, \
 "paul": { "name": "Paul", "old": 74}}' \
 | jq '.[] | .["name"], .["old"]'
"John"
40
"Paul"
74