jq レシピExplained

65 of 65 rows

フィルター↕	出力結果↕
アクセス
⤢.	入力全体を整形して出力します。
⤢.key .a.b	キーの値、またはネストしたキーの値。
⤢.["key"]	名前に特殊文字を含むキーの値。
⤢.[0]	配列の最初の要素（負の数は末尾から数えます）。
⤢.[]	配列の各要素、またはオブジェクトの各値を、それぞれ独自の行に出力します。
⤢.key?	キーの値、または null。キーが欠けていてもエラーになりません。
フィルターと選択
⤢select(cond)	条件が真なら入力をそのまま出力し、そうでなければ何も出力しません。
⤢map(expr)	配列のすべての要素に expr を適用し、結果を集めます。
⤢keys values	オブジェクトの整列済みキー名、または値の配列。
⤢length	配列または文字列の長さ、またはオブジェクトのキー数。
⤢[ .[] | select(.age > 18) ]	age が 18 より大きい要素だけを、1 つの配列にします。
コレクション
⤢any all	少なくとも 1 つの要素、またはすべての要素が truthy またはフィルターを通るとき真です。
⤢has(k) in(o)	キー k がオブジェクトに存在するとき真。in はキー側から同じ判定を実行します。
⤢first last limit(n; f)	最初の要素、最後の要素、または f の最初の n 個の出力だけ。
⤢min max	配列内の最小値、または最大値。
⤢range(n)	0 から n までの数値を、それぞれ独立した出力として生成します。
⤢flatten	ネストした配列を 1 つの平坦な配列に畳み込みます。
⤢contains(x) inside(y)	x が入力のどこかに現れるとき真。inside は役割を反転させます。
⤢walk(f)	すべての値に下から順に f を適用し、入力全体を再構築します。
変換
⤢map(.price)	各要素の price フィールドだけを集めた配列。
⤢add	数値の配列の合計、またはオブジェクトの配列のマージ。
⤢tostring tonumber	値を文字列へ、または数値形式の文字列を数値へ変換します。
⤢@json @base64	入力を JSON 文字列または base64 としてエンコードします。
⤢ascii_downcase	小文字に変換した文字列。
文字列
⤢"\(expr)"	expr の値をテキストの中に織り込んだ文字列。
⤢gsub(re; s) sub(re; s)	パターンのすべての一致、または最初の一致だけを s に置き換えます。
⤢split(s) join(s)	文字列を区切り文字で配列に分割する、または配列を 1 つの文字列に連結します。
⤢test(re) match(re) capture(re)	文字列をパターンで検査する、または一致と名前付きキャプチャを取り出します。
⤢ltrimstr(s) rtrimstr(s)	前置辞、または後置辞が存在するときだけ取り除きます。
⤢startswith(s) endswith(s)	真または偽：文字列が s で始まる、または s で終わる。
⤢ascii_upcase	大文字に変換した文字列。
⤢@csv @tsv @sh	配列を CSV 行、TSV 行、またはクオートされたシェル引数としてエンコードします。
組み替え
⤢{ id, name }	入力の id と name フィールドだけを持つ新しいオブジェクト。
⤢[ .items[] | .name ]	すべての item の name からなる配列。
⤢to_entries	オブジェクトから作った {key, value} オブジェクトの配列。
⤢from_entries	{key, value} オブジェクトの配列から構築したオブジェクト。
⤢group_by(.cat)	要素を cat フィールドごとに部分配列へグループ化します。
⤢sort_by(.x) unique_by(.id)	フィールドでソートする、または一意な id ごとに要素を 1 つだけ残します。
更新とパス
⤢.key |= f	キーの値に f を実行して更新します。
⤢.key = v	キーの値を v で上書きします。
⤢.count += n	count の値に n をその場で加算します。
⤢getpath(p) setpath(p; v) delpaths(ps)	配列として与えられたパスの値を読み取り、書き込み、削除します。
制御とロジック
⤢if c then a else b end	c が真なら a、そうでなければ b。elif で分岐を追加できます。
⤢try f catch g	f を実行し、f が失敗したときはエラーメッセージで g を実行します。
⤢error(msg)	msg を伴うエラーで停止します。try が受け止めない限り。
⤢empty	出力がまったくありません。その分岐は結果から消えます。
⤢and or not	真偽値を組み合わせる、または 1 つを反転します。
高度な操作
⤢reduce .[] as $x (0; . + $x)	配列全体を 1 つの累積合計に畳み込みます。
⤢foreach .[] as $x (a; u; e)	reduce と似ていますが、最後だけでなく各ステップの後の状態を出力します。
⤢input inputs	次の入力、または残りのすべての入力をフィルターの途中で取り込みます。
⤢tojson fromjson	値を JSON テキストとして出力する、または JSON テキストを値に戻して解析します。
⤢@base64d	base64 テキストを元の文字列にデコードします。
⤢.a.b[0] = v	構造の深部への代入。足りない階層はその過程で作成します。
⤢a // b	null でも false でもなければ a、そうでなければ b（デフォルト値）。
⤢del(.key)	1 つのキーを取り除いた入力。
⤢paths	入力内のすべてのパスをキーの配列として、上から下へ出力します。
変数と CLI
⤢--arg name val	$name をシェル文字列として定義し、フィルター内で使えるようにします。
⤢--argjson name val	$name を生の JSON から定義します。数値、真偽値、配列、オブジェクト用です。
⤢--slurpfile name file	$name を JSON ファイルの内容全体として定義します。
⤢-r	文字列の結果をクオートやエスケープなしでそのまま出力します。
⤢-c	各結果をインデントなしで 1 行にコンパクトに出力します。
⤢-n	フィルターを null に対して 1 回だけ実行し、無から出力を組み立てます。
⤢-s	フィルターが実行される前に、入力全体を 1 つの配列へ読み込みます。
⤢-e	最後の出力から終了コードを設定し、シェルスクリプトが結果を判定できるようにします。
⤢env.VAR	フィルター内から読み取る環境変数の値。