Przepisy jqExplained

65 of 65 rows

Filtr↕	Co daje↕
Dostęp
⤢.	Całe wejście, sformatowane czytelnie.
⤢.key .a.b	Wartość pod kluczem lub kluczami zagnieżdżonymi.
⤢.["key"]	Wartość pod kluczem, którego nazwa zawiera znaki specjalne.
⤢.[0]	Pierwszy element tablicy (ujemny indeks liczy od końca).
⤢.[]	Każdy element tablicy albo każda wartość obiektu, w osobnej linii.
⤢.key?	Wartość pod kluczem albo null, bez błędu, gdy klucz nie istnieje.
Filtrowanie i wybieranie
⤢select(cond)	Wejście niezmienione, gdy cond jest prawdą, w przeciwnym razie nic.
⤢map(expr)	Zastosuj expr do każdego elementu tablicy i zbierz wyniki.
⤢keys values	Posortowane nazwy kluczy albo wartości obiektu w postaci tablicy.
⤢length	Długość tablicy lub napisu albo liczba kluczy w obiekcie.
⤢[ .[] | select(.age > 18) ]	Tylko elementy, których age jest większe od 18, w jednej tablicy.
Kolekcje
⤢any all	Prawda, gdy co najmniej jeden albo gdy każdy element jest prawdziwy lub przejdzie filtr.
⤢has(k) in(o)	Prawda, gdy klucz k istnieje w obiekcie; in wykonuje ten sam test od strony klucza.
⤢first last limit(n; f)	Pierwszy element, ostatni albo tylko pierwsze n wyników f.
⤢min max	Najmniejsza albo największa wartość w tablicy.
⤢range(n)	Liczby od 0 do n, każda jako osobny wynik.
⤢flatten	Tablice zagnieżdżone spłaszczone w jedną płaską tablicę.
⤢contains(x) inside(y)	Prawda, gdy x występuje gdzieś wewnątrz wejścia; inside odwraca role.
⤢walk(f)	Stosuje f do każdej wartości od dołu do góry, potem odbudowuje całe wejście.
Przekształcanie
⤢map(.price)	Tablica zawierająca tylko pole price z każdego elementu.
⤢add	Suma tablicy liczb albo scalenie tablicy obiektów.
⤢tostring tonumber	Zamień wartość na napis albo numeryczny napis na liczbę.
⤢@json @base64	Koduje wejście jako napis JSON albo base64.
⤢ascii_downcase	Napis z małymi literami.
Napisy
⤢"\(expr)"	Napis z wartością expr wplecioną w tekst.
⤢gsub(re; s) sub(re; s)	Zamień każde dopasowanie wzorca albo tylko pierwsze na s.
⤢split(s) join(s)	Rozbij napis na tablicę po separatorze albo sklej tablicę w jeden napis.
⤢test(re) match(re) capture(re)	Sprawdź napis względem wzorca albo wydobądź dopasowania i nazwane grupy.
⤢ltrimstr(s) rtrimstr(s)	Usuwa prefiks albo sufiks, tylko gdy jest obecny.
⤢startswith(s) endswith(s)	Prawda lub fałsz: napis zaczyna się albo kończy od s.
⤢ascii_upcase	Napis z wielkimi literami.
⤢@csv @tsv @sh	Tablica zakodowana jako wiersz CSV, wiersz TSV albo zacytowane argumenty powłoki.
Przebudowa
⤢{ id, name }	Nowy obiekt z tylko polami id i name z wejścia.
⤢[ .items[] | .name ]	Tablica z name każdego elementu.
⤢to_entries	Tablica obiektów {key, value} powstała z obiektu.
⤢from_entries	Obiekt zbudowany z tablicy obiektów {key, value}.
⤢group_by(.cat)	Elementy pogrupowane w podtablice według pola cat.
⤢sort_by(.x) unique_by(.id)	Sortuj po polu albo zostaw jeden element na każdy odrębny id.
Aktualizacja i ścieżki
⤢.key |= f	Aktualizuje wartość pod kluczem, uruchamiając na niej f.
⤢.key = v	Nadpisuje wartość pod kluczem wartością v.
⤢.count += n	Dodaje n do wartości count, w miejscu.
⤢getpath(p) setpath(p; v) delpaths(ps)	Odczytuje, zapisuje albo usuwa wartości na ścieżkach podanych jako tablice.
Sterowanie i logika
⤢if c then a else b end	a, gdy c jest prawdą, w przeciwnym razie b, z elif dla kolejnych gałęzi.
⤢try f catch g	Uruchamia f, a gdy f zawiedzie, uruchamia g z komunikatem błędu.
⤢error(msg)	Kończy z błędem niosącym msg, chyba że try go przechwyci.
⤢empty	Żadnego wyjścia; ta gałąź po prostu znika z wyników.
⤢and or not	Łączy wartości prawda i fałsz albo odwraca jedną z nich.
Zaawansowane
⤢reduce .[] as $x (0; . + $x)	Zwija całą tablicę w jedną narastającą sumę.
⤢foreach .[] as $x (a; u; e)	Jak reduce, ale emituje stan po każdym kroku, nie tylko ostatni.
⤢input inputs	Następne wejście albo wszystkie pozostałe wejścia, wczytane w trakcie filtra.
⤢tojson fromjson	Wartość jako tekst JSON albo tekst JSON sparsowany z powrotem na wartość.
⤢@base64d	Tekst base64 zdekodowany z powrotem do oryginalnego napisu.
⤢.a.b[0] = v	Przypisanie głęboko w strukturze, tworzące po drodze brakujące poziomy.
⤢a // b	a, jeśli nie jest null ani fałszem, w przeciwnym razie b (wartość domyślna).
⤢del(.key)	Wejście z jednym usuniętym kluczem.
⤢paths	Każda ścieżka w wejściu jako tablica kluczy, od góry do dołu.
Zmienne i CLI
⤢--arg name val	Definiuje $name jako napis powłoki, używalny wewnątrz filtra.
⤢--argjson name val	Definiuje $name z surowego JSON, dla liczb, wartości logicznych, tablic lub obiektów.
⤢--slurpfile name file	Definiuje $name jako całą zawartość pliku JSON.
⤢-r	Wypisuje wyniki napisowe bez cudzysłowów i znaków ucieczki.
⤢-c	Wypisuje każdy wynik kompaktowo w jednej linii, bez wcięć.
⤢-n	Uruchamia filtr raz na null, żeby zbudować wyjście z niczego.
⤢-s	Wczytuje całe wejście do jednej tablicy przed uruchomieniem filtra.
⤢-e	Ustawia kod wyjścia z ostatniego wyniku, żeby skrypty powłoki mogły go testować.
⤢env.VAR	Wartość zmiennej środowiskowej, odczytana wewnątrz filtra.