Рецепти jqExplained

65 of 65 rows

Фільтр↕	Що дає↕
Доступ
⤢.	Увесь ввід, форматований для читання.
⤢.key .a.b	Значення за ключем, або за вкладеними ключами.
⤢.["key"]	Значення за ключем, чия назва містить спеціальні символи.
⤢.[0]	Перший елемент масиву (від'ємний індекс рахує з кінця).
⤢.[]	Кожен елемент масиву, або кожне значення об'єкта, в окремому рядку.
⤢.key?	Значення за ключем, або null, без помилки, коли ключа немає.
Фільтрація та вибір
⤢select(cond)	Ввід без змін, коли умова істинна, інакше нічого.
⤢map(expr)	Застосувати вираз до кожного елемента масиву і зібрати результати.
⤢keys values	Відсортовані назви ключів, або значення, об'єкта як масив.
⤢length	Довжина масиву або рядка, або кількість ключів в об'єкті.
⤢[ .[] | select(.age > 18) ]	Лише елементи, чиє age більше за 18, одним масивом.
Колекції
⤢any all	Істина, коли хоч один елемент, або коли кожен елемент, є істинним або проходить фільтр.
⤢has(k) in(o)	Істина, коли ключ k існує в об'єкті; in виконує той самий тест зі сторони ключа.
⤢first last limit(n; f)	Перший елемент, останній, або лише перші n виводів f.
⤢min max	Найменше, або найбільше, значення в масиві.
⤢range(n)	Числа від 0 до n, кожне як окремий вивід.
⤢flatten	Вкладені масиви, згорнуті в один плоский масив.
⤢contains(x) inside(y)	Істина, коли x трапляється десь у вводі; inside міняє ролі.
⤢walk(f)	Застосувати f до кожного значення знизу вгору, потім відбудувати ввесь ввід.
Перетворення
⤢map(.price)	Масив лише з поля price кожного елемента.
⤢add	Сума масиву чисел, або злиття масиву об'єктів.
⤢tostring tonumber	Привести значення до рядка, або числовий рядок до числа.
⤢@json @base64	Кодувати ввід як JSON-рядок або base64.
⤢ascii_downcase	Рядок у нижньому регістрі.
Рядки
⤢"\(expr)"	Рядок зі значенням виразу, вплетеним у текст.
⤢gsub(re; s) sub(re; s)	Замінити кожен збіг шаблону, або лише перший, на s.
⤢split(s) join(s)	Розбити рядок на масив за роздільником, або склеїти масив в один рядок.
⤢test(re) match(re) capture(re)	Перевірити рядок проти шаблону, або витягти збіги та іменовані групи.
⤢ltrimstr(s) rtrimstr(s)	Зрізати префікс, або суфікс, лише коли він є.
⤢startswith(s) endswith(s)	Істина чи хибність: рядок починається, або закінчується, на s.
⤢ascii_upcase	Рядок у верхньому регістрі.
⤢@csv @tsv @sh	Масив, кодований як CSV-рядок, TSV-рядок або взяті в лапки аргументи shell.
Зміна форми
⤢{ id, name }	Новий об'єкт лише з полями id та name вводу.
⤢[ .items[] | .name ]	Масив імен усіх елементів items.
⤢to_entries	Масив об'єктів {key, value} з об'єкта.
⤢from_entries	Об'єкт, збудований з масиву об'єктів {key, value}.
⤢group_by(.cat)	Елементи, згруповані в підмасиви за полем cat.
⤢sort_by(.x) unique_by(.id)	Сортувати за полем, або лишити один елемент на кожен різний id.
Оновлення та шляхи
⤢.key |= f	Оновити значення за ключем, пропустивши його через f.
⤢.key = v	Перезаписати значення за ключем на v.
⤢.count += n	Додати n до значення за count, на місці.
⤢getpath(p) setpath(p; v) delpaths(ps)	Читати, записувати або видаляти значення за шляхами, заданими як масиви.
Керування та логіка
⤢if c then a else b end	a, коли c істинне, інакше b; elif — для додаткових гілок.
⤢try f catch g	Виконати f; коли f ламається, натомість виконати g з текстом помилки.
⤢error(msg)	Зупинитися з помилкою, що несе msg, якщо тільки try її не перехопить.
⤢empty	Взагалі жодного виводу; ця гілка просто зникає з результатів.
⤢and or not	Поєднувати істинні та хибні значення, або перевернути одне.
Просунуте
⤢reduce .[] as $x (0; . + $x)	Згорнути ввесь масив в одну наростаючу суму.
⤢foreach .[] as $x (a; u; e)	Як reduce, але видає стан після кожного кроку, а не лише останнього.
⤢input inputs	Наступний ввід, або ввесь решта вводу, підтягнутий посеред фільтра.
⤢tojson fromjson	Значення як JSON-текст, або JSON-текст, розібраний назад у значення.
⤢@base64d	Base64-текст, декодований назад в оригінальний рядок.
⤢.a.b[0] = v	Присвоєння в глибині структури, що створює відсутні рівні на шляху.
⤢a // b	a, якщо воно не null і не false, інакше b (значення за замовчуванням).
⤢del(.key)	Ввіз з одним вилученим ключем.
⤢paths	Кожен шлях у вводі як масив ключів, зверху вниз.
Змінні та CLI
⤢--arg name val	Визначити $name як рядок зі shell, придатний до вживання у фільтрі.
⤢--argjson name val	Визначити $name з сирого JSON, для чисел, булевих значень, масивів або об'єктів.
⤢--slurpfile name file	Визначити $name як увесь вміст JSON-файлу.
⤢-r	Друкувати рядкові результати як є, без лапок і екранувань.
⤢-c	Друкувати кожен результат компактно в один рядок, без відступів.
⤢-n	Виконати фільтр один раз на null, щоб збудувати вивід з нічого.
⤢-s	Прочитати ввесь ввід в один масив до запуску фільтра.
⤢-e	Встановити код виходу з останнього виводу, щоб shell-скрипти могли перевіряти результат.
⤢env.VAR	Значення змінної середовища, прочитане всередині фільтра.