Recepty jqExplained

65 of 65 rows

Filtr↕	Co dává↕
Přístup
⤢.	Celý vstup, hezky formátovaný.
⤢.key .a.b	Hodnota pod klíčem, nebo pod zanořenými klíči.
⤢.["key"]	Hodnota pod klíčem, jehož název obsahuje speciální znaky.
⤢.[0]	První prvek pole (záporné číslo počítá od konce).
⤢.[]	Každý prvek pole, nebo každá hodnota objektu, každá na vlastním řádku.
⤢.key?	Hodnota pod klíčem, nebo null, bez chyby, když klíč chybí.
Filtrování a výběr
⤢select(cond)	Vstup nezměněný, když je cond pravdivé, jinak nic.
⤢map(expr)	Aplikuje expr na každý prvek pole a posbírá výsledky.
⤢keys values	Seřazené názvy klíčů, nebo hodnoty, objektu jako pole.
⤢length	Délka pole nebo řetězce, nebo počet klíčů objektu.
⤢[ .[] | select(.age > 18) ]	Pouze prvky s věkem větším než 18, jako jediné pole.
Kolekce
⤢any all	Pravda, když aspoň jeden prvek, nebo když každý prvek, je truthy nebo projde filtrem.
⤢has(k) in(o)	Pravda, když klíč k v objektu existuje; in spustí stejný test z pozice klíče.
⤢first last limit(n; f)	První prvek, poslední, nebo jen prvních n výstupů f.
⤢min max	Nejmenší, nebo největší hodnota v poli.
⤢range(n)	Čísla od 0 do n, každé jako vlastní výstup.
⤢flatten	Zanořená pole zploštělá do jediného plochého pole.
⤢contains(x) inside(y)	Pravda, když se x někde ve vstupu vyskytuje; inside obrací role.
⤢walk(f)	Aplikuje f na každou hodnotu odspodu nahoru a pak znovu sestaví celý vstup.
Transformace
⤢map(.price)	Pole jen s polem price každého prvku.
⤢add	Součet pole čísel, nebo sloučení pole objektů.
⤢tostring tonumber	Převede hodnotu na řetězec, nebo číselný řetězec na číslo.
⤢@json @base64	Zakóduje vstup jako JSON řetězec nebo base64.
⤢ascii_downcase	Řetězec převedený na malá písmena.
Řetězce
⤢"\(expr)"	Řetězec s hodnotou expr vpletenou do textu.
⤢gsub(re; s) sub(re; s)	Nahradí každou shodu vzoru, nebo jen první, hodnotou s.
⤢split(s) join(s)	Rozbije řetězec na pole podle oddělovače, nebo slepí pole do jednoho řetězce.
⤢test(re) match(re) capture(re)	Otestuje řetězec proti vzoru, nebo vytáhne shody a pojmenované zachycené skupiny.
⤢ltrimstr(s) rtrimstr(s)	Odstraní předponu, nebo příponu, jen když je přítomna.
⤢startswith(s) endswith(s)	Pravda nebo nepravda: řetězec začíná, nebo končí, řetězcem s.
⤢ascii_upcase	Řetězec převedený na velká písmena.
⤢@csv @tsv @sh	Pole zakódované jako řádek CSV, řádek TSV, nebo quotované shell argumenty.
Přeformování
⤢{ id, name }	Nový objekt jen s poli id a name ze vstupu.
⤢[ .items[] | .name ]	Pole se jménem každé položky.
⤢to_entries	Pole objektů {key, value} vytvořené z objektu.
⤢from_entries	Objekt poskládaný z pole objektů {key, value}.
⤢group_by(.cat)	Prvky seskupené do podpolí podle jejich pole cat.
⤢sort_by(.x) unique_by(.id)	Seřadí podle pole, nebo ponechá jeden prvek na každou odlišnou hodnotu id.
Aktualizace a cesty
⤢.key |= f	Aktualizuje hodnotu na klíči tak, že na ni spustí f.
⤢.key = v	Přepíše hodnotu na klíči hodnotou v.
⤢.count += n	Přičte n k hodnotě count na místě.
⤢getpath(p) setpath(p; v) delpaths(ps)	Přečte, zapíše nebo smaže hodnoty na cestách zadaných jako pole.
Řízení a logika
⤢if c then a else b end	a, když je c pravdivé, jinak b, s elif pro další větve.
⤢try f catch g	Spustí f, a když f selže, spustí místo něj g s chybovou zprávou.
⤢error(msg)	Zastaví s chybou nesoucí msg, pokud ji nechytí try.
⤢empty	Žádný výstup; ta větev prostě z výsledků zmizí.
⤢and or not	Kombinuje hodnoty pravda a nepravda, nebo jednu převrátí.
Pokročilé
⤢reduce .[] as $x (0; . + $x)	Složí celé pole do jediného běžícího součtu.
⤢foreach .[] as $x (a; u; e)	Jako reduce, ale emituje stav po každém kroku, ne jen poslední.
⤢input inputs	Další vstup, nebo všechny zbývající vstupy, vtahované uprostřed filtru.
⤢tojson fromjson	Hodnota jako JSON text, nebo JSON text parsovaný zpět na hodnotu.
⤢@base64d	Base64 text dekódovaný zpět na původní řetězec.
⤢.a.b[0] = v	Přiřazení hluboko ve struktuře, chybějící úrovně se cestou vytvoří.
⤢a // b	a, pokud není null ani false, jinak b (výchozí hodnota).
⤢del(.key)	Vstup s jedním odstraněným klíčem.
⤢paths	Každá cesta ve vstupu jako pole klíčů, odshora dolů.
Proměnné a CLI
⤢--arg name val	Definuje $name jako shell řetězec, použitelný uvnitř filtru.
⤢--argjson name val	Definuje $name z raw JSON, pro čísla, booleany, pole nebo objekty.
⤢--slurpfile name file	Definuje $name jako celý obsah JSON souboru.
⤢-r	Vytiskne výsledky typu řetězec syrově, bez uvozovek a escape sekvencí.
⤢-c	Vytiskne každý výstup kompaktně na jeden řádek, bez odsazení.
⤢-n	Spustí filtr jednou nad null, aby postavil výstup z ničeho.
⤢-s	Přečte celý vstup do jednoho pole dřív, než filtr poběží.
⤢-e	Nastaví exit kód podle posledního výstupu, aby shell skripty mohly výsledek testovat.
⤢env.VAR	Hodnota proměnné prostředí, přečtená uvnitř filtru.