https://tro3373.github.io/tags/jq/ Recent content in jq on tac lifelog https://tro3373.github.io/favicon.png https://tro3373.github.io/favicon.png Hugo ja Mon, 09 Nov 2026 13:36:09 +0900 https://tro3373.github.io/posts/2026/2026-11-09-jq-input-truthiness-shell-boundary/ Mon, 09 Nov 2026 13:36:09 +0900 https://tro3373.github.io/posts/2026/2026-11-09-jq-input-truthiness-shell-boundary/ <h2 id="結論">結論</h2> <ul> <li>jq に渡す <code>.</code> や <code>.branch</code> のような式をフィルタと呼ぶ。jq の入力は「JSON 値の並び」で、フィルタは値ごとに動く。連結した JSON は値の数だけ結果を出し、壊れた箇所の手前の値は、終了コード 5 で失敗しても stdout に出る。1 値だけを受けるなら <code>-s</code> で全体を読み、<code>length == 1</code> と型を確かめる</li> <li><code>-s</code> は全部を読めてから配列を作るので、1 行でも壊れた JSON Lines (1 行に 1 つの JSON を書く形式) では何も出さない。壊れた行だけを捨てるなら <code>-R</code> と <code>fromjson?</code> を使う</li> <li>偽になるのは <code>false</code> と <code>null</code> だけで、<code>0</code>・<code>&quot;&quot;</code>・<code>[]</code> は真、無い項目は <code>null</code> になる。<code>//</code> は <code>false</code> も右辺に置き換える。フラグの判定は真偽でなく <code>== false</code> や <code>&gt; 0</code> の比較で書く</li> <li>ツリーを辿る <code>recurse(.children[])</code> は <code>children</code> の無いノードで止まるので、エラーを捨てる <code>?</code> を付ける。祖先の条件を子孫に効かせるなら、後段の <code>select</code> (条件が真の値だけを残す関数) でなく <code>recurse(f; cond)</code> に書く</li> <li>シェルとの境目では値の形が変わる。<code>@tsv</code> は <code>\</code> を二重にし、<code>IFS=$'\t' read</code> は空の列を詰め、<code>--arg</code> (シェルの値を jq の変数に渡すオプション) の値は 1 個 128 KiB までしか渡せない。1 件ごとに jq を起動すると、jq 1 回で全件を出す形より桁で遅い</li> </ul> <p>以下は jq 1.8.2 / GNU bash 5.3.20 / Linux x86_64 で実測した。出力の <code>rc=</code> は <code>echo &quot;rc=$?&quot;</code> で出した終了コードで、stderr のエラー文が stdout より先に並ぶのは、パイプへの stdout がバッファされ、終了時に書かれるためである。</p>