jq-reseptitExplained

65 of 65 rows

Suodatin↕	Mitä se tuottaa↕
Pääsy
⤢.	Koko syöte tulostettuna kauniisti.
⤢.key .a.b	Arvo avaimesta tai sisäkkäisistä avaimista.
⤢.["key"]	Arvo avaimesta, jonka nimessä on erikoismerkkejä.
⤢.[0]	Taulukon ensimmäinen alkio (negatiivinen laskee lopusta).
⤢.[]	Taulukon jokainen alkio tai objektin jokainen arvo omalla rivillään.
⤢.key?	Avaimen arvo tai null ilman virhettä, kun avain puuttuu.
Suodatus ja valinta
⤢select(cond)	Syöte muuttumattomana, kun cond on tosi, muuten ei mitään.
⤢map(expr)	Soveltaa expr:ää taulukon jokaiseen alkioon ja kerää tulokset.
⤢keys values	Objektin lajitellut avainnimet tai arvot taulukkona.
⤢length	Taulukon tai merkkijonon pituus tai objektin avainten määrä.
⤢[ .[] | select(.age > 18) ]	Vain alkiot, joiden ikä on yli 18, yhtenä taulukkona.
Kokoelmat
⤢any all	Tosi, kun vähintään yksi tai kun jokainen alkio on truthy tai läpäisee suodattimen.
⤢has(k) in(o)	Tosi, kun avain k on olemassa objektissa; in ajaa saman testin avaimen puolelta.
⤢first last limit(n; f)	Ensimmäinen alkio, viimeinen tai vain f:n n ensimmäistä tulosta.
⤢min max	Taulukon pienin tai suurin arvo.
⤢range(n)	Luvut 0:sta ylös n:ään, kukin omana tuloksenaan.
⤢flatten	Sisäkkäiset taulukot litistettyinä yhdeksi tasaiseksi taulukoksi.
⤢contains(x) inside(y)	Tosi, kun x esiintyy jossakin syötteen sisällä; inside kääntää roolit.
⤢walk(f)	Soveltaa f:ää jokaiseen arvoon alhaalta ylös ja rakentaa sitten koko syötteen uudelleen.
Muuntaminen
⤢map(.price)	Taulukko, jossa vain jokaisen alkion price-kenttä.
⤢add	Numerotaulukon summa tai objektitaulukon yhdistelmä.
⤢tostring tonumber	Muuntaa arvon merkkijonoksi tai numeerisen merkkijonon numeroksi.
⤢@json @base64	Koodaa syötteen JSON-merkkijonoksi tai base64:ksi.
⤢ascii_downcase	Merkkijono pienillä kirjaimilla.
Merkkijonot
⤢"\(expr)"	Merkkijono, johon expr:n arvo on liitetty tekstiin.
⤢gsub(re; s) sub(re; s)	Korvaa jokaisen osuman tai vain ensimmäisen merkkijonolla s.
⤢split(s) join(s)	Pilkkoo merkkijonon taulukoksi erottimen kohdalta tai liittää taulukon yhdeksi merkkijonoksi.
⤢test(re) match(re) capture(re)	Testaa merkkijonoa kaavaa vastaan tai nostaa esiin osumat ja nimetyt ryhmät.
⤢ltrimstr(s) rtrimstr(s)	Poistaa etuliitteen tai loppuliitteen vain, kun se on läsnä.
⤢startswith(s) endswith(s)	Tosi tai epätosi: merkkijono alkaa tai päättyy merkkijonoon s.
⤢ascii_upcase	Merkkijono isoilla kirjaimilla.
⤢@csv @tsv @sh	Taulukko koodattuna CSV-riviksi, TSV-riviksi tai lainatuiksi komentoriviargumenteiksi.
Uudelleenmuotoilu
⤢{ id, name }	Uusi objekti, jossa vain syötteen id- ja name-kentät.
⤢[ .items[] | .name ]	Taulukko jokaisen alkion nimestä.
⤢to_entries	Taulukko {key, value} -objekteja objektista.
⤢from_entries	Objekti {key, value} -objektien taulukosta.
⤢group_by(.cat)	Alkiot ryhmiteltynä taulukoihin cat-kentän mukaan.
⤢sort_by(.x) unique_by(.id)	Järjestää kentän mukaan tai säilyttää yhden alkion kutakin erillistä id:tä kohti.
Päivitys ja polut
⤢.key |= f	Päivittää avaimen arvon suorittamalla sille f:n.
⤢.key = v	Korvaa avaimen arvolla v.
⤢.count += n	Lisää n count-arvoon paikallaan.
⤢getpath(p) setpath(p; v) delpaths(ps)	Lukee, kirjoittaa tai poistaa arvoja taulukoina annetuista poluista.
Ohjaus ja logiikka
⤢if c then a else b end	a, kun c on tosi, muuten b, elif lisää haaroja.
⤢try f catch g	Ajaa f:n ja ajaa g:n virheviestillä, kun f epäonnistuu.
⤢error(msg)	Pysähtyy virheeseen, joka kantaa msg:ää, ellei try ota sitä kiinni.
⤢empty	Ei lainkaan tulosta; haara katoaa yksinkertaisesti tuloksista.
⤢and or not	Yhdistää tosi- ja epätosi-arvoja tai kääntää yhden.
Edistynyt
⤢reduce .[] as $x (0; . + $x)	Laskostaa koko taulukon yhdeksi juoksevaksi summaksi.
⤢foreach .[] as $x (a; u; e)	Kuten reduce, mutta emittoi tilan jokaisen vaiheen jälkeen, ei vain viimeisen.
⤢input inputs	Seuraava syöte tai kaikki jäljellä olevat syötteet vedettynä suodattimen keskellä.
⤢tojson fromjson	Arvo JSON-tekstinä tai JSON-teksti jäsennettynä takaisin arvoksi.
⤢@base64d	Base64-teksti dekoodattuna takaisin alkuperäiseksi merkkijonoksi.
⤢.a.b[0] = v	Sijoitus rakenteen syvyyteen, luoden puuttuvat tasot matkan varrelle.
⤢a // b	a, jos se ei ole null tai epätosi, muuten b (oletusarvo).
⤢del(.key)	Syöte yhdellä avaimella poistettuna.
⤢paths	Jokainen polku syötteen sisällä avainten taulukkona, ylhäältä alas.
Muuttujat ja CLI
⤢--arg name val	Määrittelee $name shell-merkkijonona, käytettävissä suodattimen sisällä.
⤢--argjson name val	Määrittelee $name raakasta JSON:ista lukuja, booleaneja, taulukoita tai objekteja varten.
⤢--slurpfile name file	Määrittelee $name JSON-tiedoston koko sisältönä.
⤢-r	Tulostaa merkkijonotulokset raakana, ilman lainausmerkkejä tai escapeja.
⤢-c	Tulostaa jokaisen tuloksen tiiviisti yhdellä rivillä ilman sisennystä.
⤢-n	Ajaa suodattimen kerran null:lla, rakentaakseen tuloksen tyhjästä.
⤢-s	Lukee koko syötteen yhdeksi taulukoksi ennen suodattimen ajoa.
⤢-e	Asettaa poistumiskoodin viimeisen tuloksen perusteella, jotta shell-skriptit voivat testata tuloksen.
⤢env.VAR	Ympäristömuuttujan arvo, luettuna suodattimen sisällä.