乗り物の購入

比較

数値の比較

jqでは、数値を次の比較演算子と等価演算子で比較できます。

比較の結果は常に真偽値で、trueかfalseのどちらかになります。

1 < 3,      # => true
2 != 2,     # => false
1 == 1.0    # => true
            # All numbers are floating-points, so this is different syntax
            # for the exact same value.

文字列の比較

上記の比較演算子は、文字列の比較にも使えます。 その場合は、辞書式順序（辞書順）が適用されます。 順序は_Unicodeコードポイントの値_によって決まります。

"Apple" > "Pear",   # => false
"a" < "above",      # => true
"a" == "A"          # => false

数値が入っているように見えても型が文字列である2つの変数を比較するときは、注意が必要です。 辞書順のため、結果は数値型の値を比較した場合と同じにはなりません。

10 < 2,     # => false
"10" < "2"  # => true (because "1" comes before "2")

「厳密な」等価性

jqの==演算子は、見た目が同じでも型が異なるものは等しくないという点で、JavaScriptの===に似ています。

"3" == 3    # => false
            # the value on the left has type string,
            # the value on the right has type number.

配列の比較

2つの配列は、対応するすべての要素が等しければ等しいとみなされます。

[1, 2, 3] == [1, 2, 3]      # => true
[1, 2, 3] == [1, 3, 2]      # => false, different order
[1, 2, 3] == [1, 2, "3"]    # => false, different types

オブジェクトの比較

2つのオブジェクトは、同じキーと値のペアを持っていれば等しいとみなされます。

{name: "Joe", age: 42} == {age: 42, name: "Joe"}                # => true
{name: "Joe", age: 42} == {age: 42, name: "Jane"}               # => false
{name: "Joe", age: 42} == {age: "42", name: "Joe"}              # => false
{name: "Joe", age: 42} == {age: 42, name: "Joe", height: 175}   # => false

# comparisons will drill down as deeply as required
{a: {b: {c: [1, 2]}}} == {a: {b: {c: [1, 2]}}}                  # => true
{a: {b: {c: [1, 2]}}} == {a: {b: {c: [1, 2, 3]}}}               # => false

条件分岐

if式

jqの条件式はif A then B else C endです。

if-then-elseは、他のすべてのjqの組み込み関数と同じくフィルターです。入力を受け取り、出力を生成します。

式Aが「真とみなされる」値を生成すると、ifフィルターはBを評価します。 そうでなければ、Cを評価します。 ifフィルターへの入力は、BまたはCに渡されます。

42 | if . < 50 then "small" else "big" end      # => "small"

5 | if . % 2 == 0 then . / 2 else . * 4 end     # => 20

if A then B else . end
if A then B end

入れ子のif文

elifを使うと、さらに条件を追加できます。

42 | if . < 33 then "small"
     elif . < 66 then "medium"
     else "big"
     end
# => "medium"

elif節は必要なだけいくつでも使えます。

真偽の判定

jqで「偽」となる値はfalseとnullだけです。 それ以外はすべて「真」になります。数値のゼロ、空の文字列・配列・オブジェクトでさえも「真」です。

真偽値演算子

真偽値演算子のandとorを使うと、複雑なクエリを組み立てられます。

42 | if . < 33 or . > 66 then "big or small"
     else "medium"
     end

否定するには、notを使います。これは演算子ではなくフィルターです。

42 | if (. < 33 or . > 66 | not) then "medium"
     else "big or small"
     end

代替演算子

代替演算子を使うと、式が偽またはnullの場合の「デフォルト」値を指定できます。

A // B

# This is identical to
if A then A else B end

例を見てみましょう。

[3, 5, 18] | add / 2       # => 13
[]         | add / 2       # => error: null (null) and number (2) cannot be divided
[]         | add // 0 / 2  # => 0