Công thức jqExplained

65 of 65 rows

Bộ lọc↕	Kết quả tạo ra↕
Truy cập
⤢.	Toàn bộ đầu vào, in định dạng đẹp.
⤢.key .a.b	Giá trị tại một khóa, hoặc các khóa lồng nhau.
⤢.["key"]	Giá trị tại một khóa có tên chứa ký tự đặc biệt.
⤢.[0]	Phần tử đầu tiên của mảng (số âm đếm từ cuối).
⤢.[]	Từng phần tử của mảng, hoặc từng giá trị của đối tượng, mỗi cái một dòng.
⤢.key?	Giá trị tại khóa, hoặc null, không báo lỗi khi khóa thiếu.
Lọc và chọn
⤢select(cond)	Đầu vào giữ nguyên khi điều kiện đúng, ngược lại không có gì.
⤢map(expr)	Áp dụng biểu thức cho từng phần tử của mảng và gom kết quả lại.
⤢keys values	Tên khóa đã sắp xếp, hoặc các giá trị, của một đối tượng dạng mảng.
⤢length	Độ dài của mảng hoặc chuỗi, hoặc số khóa trong đối tượng.
⤢[ .[] | select(.age > 18) ]	Chỉ những phần tử có age lớn hơn 18, gom thành một mảng.
Tập hợp
⤢any all	Đúng khi ít nhất một phần tử, hoặc khi tất cả phần tử, là truthy hoặc vượt qua bộ lọc.
⤢has(k) in(o)	Đúng khi khóa k tồn tại trong đối tượng; in chạy cùng phép thử đó từ phía khóa.
⤢first last limit(n; f)	Phần tử đầu tiên, phần tử cuối, hoặc chỉ n kết quả đầu của f.
⤢min max	Giá trị nhỏ nhất, hoặc lớn nhất, trong mảng.
⤢range(n)	Các số từ 0 đến n, mỗi số một kết quả riêng.
⤢flatten	Mảng lồng nhau bị ép thành một mảng phẳng duy nhất.
⤢contains(x) inside(y)	Đúng khi x xuất hiện ở đâu đó trong đầu vào; inside đảo vai trò.
⤢walk(f)	Áp dụng f cho từng giá trị từ dưới lên, rồi dựng lại toàn bộ đầu vào.
Biến đổi
⤢map(.price)	Một mảng chỉ chứa trường price từ từng phần tử.
⤢add	Tổng của một mảng số, hoặc sự hợp nhất của một mảng đối tượng.
⤢tostring tonumber	Ép một giá trị thành chuỗi, hoặc một chuỗi số thành số.
⤢@json @base64	Mã hóa đầu vào thành chuỗi JSON hoặc base64.
⤢ascii_downcase	Chuỗi được chuyển thành chữ thường.
Chuỗi
⤢"\(expr)"	Một chuỗi có giá trị của biểu thức được chèn vào văn bản.
⤢gsub(re; s) sub(re; s)	Thay mọi chỗ khớp mẫu, hoặc chỉ chỗ đầu tiên, bằng s.
⤢split(s) join(s)	Tách chuỗi thành mảng theo dấu phân cách, hoặc dán mảng thành một chuỗi.
⤢test(re) match(re) capture(re)	Kiểm tra chuỗi với một mẫu, hoặc trích các chỗ khớp và nhóm bắt có tên.
⤢ltrimstr(s) rtrimstr(s)	Cắt tiền tố, hoặc hậu tố, chỉ khi nó có mặt.
⤢startswith(s) endswith(s)	Đúng hoặc sai: chuỗi bắt đầu, hoặc kết thúc, bằng s.
⤢ascii_upcase	Chuỗi được chuyển thành chữ hoa.
⤢@csv @tsv @sh	Một mảng được mã hóa thành dòng CSV, dòng TSV, hoặc đối số shell có nháy.
Định hình lại
⤢{ id, name }	Một đối tượng mới chỉ chứa các trường id và name của đầu vào.
⤢[ .items[] | .name ]	Một mảng tên của mọi item.
⤢to_entries	Một mảng các đối tượng {key, value} lấy từ một đối tượng.
⤢from_entries	Một đối tượng dựng từ mảng các đối tượng {key, value}.
⤢group_by(.cat)	Các phần tử được nhóm thành mảng con theo trường cat.
⤢sort_by(.x) unique_by(.id)	Sắp xếp theo một trường, hoặc giữ một phần tử cho mỗi id khác biệt.
Cập nhật và đường dẫn
⤢.key |= f	Cập nhật giá trị tại khóa bằng cách chạy f trên nó.
⤢.key = v	Ghi đè giá trị tại khóa bằng v.
⤢.count += n	Cộng n vào giá trị tại count, ngay tại chỗ.
⤢getpath(p) setpath(p; v) delpaths(ps)	Đọc, ghi, hoặc xóa giá trị tại các đường dẫn cho dưới dạng mảng.
Điều khiển và logic
⤢if c then a else b end	a khi c đúng, ngược lại b; dùng elif cho nhiều nhánh hơn.
⤢try f catch g	Chạy f, và chạy g với thông báo lỗi thay thế khi f thất bại.
⤢error(msg)	Dừng với một lỗi mang theo msg, trừ khi một try bắt được nó.
⤢empty	Hoàn toàn không có đầu ra; nhánh đó cứ thế biến mất khỏi kết quả.
⤢and or not	Kết hợp các giá trị đúng và sai, hoặc đảo một giá trị.
Nâng cao
⤢reduce .[] as $x (0; . + $x)	Gộp toàn bộ mảng thành một tổng tích lũy.
⤢foreach .[] as $x (a; u; e)	Giống reduce, nhưng phát trạng thái sau mỗi bước, chứ không chỉ bước cuối.
⤢input inputs	Đầu vào kế tiếp, hoặc mọi đầu vào còn lại, được kéo vào giữa chừng bộ lọc.
⤢tojson fromjson	Một giá trị dạng văn bản JSON, hoặc văn bản JSON được phân tích ngược thành giá trị.
⤢@base64d	Văn bản base64 được giải mã về chuỗi gốc.
⤢.a.b[0] = v	Gán giá trị sâu trong cấu trúc, tự tạo các cấp còn thiếu trên đường đi.
⤢a // b	a nếu nó không phải null hay false, nếu không thì b (giá trị mặc định).
⤢del(.key)	Đầu vào với một khóa bị loại bỏ.
⤢paths	Mọi đường dẫn trong đầu vào dạng mảng các khóa, từ trên xuống.
Biến và CLI
⤢--arg name val	Định nghĩa $name là một chuỗi shell, dùng được bên trong bộ lọc.
⤢--argjson name val	Định nghĩa $name từ JSON thô, dành cho số, boolean, mảng, hoặc đối tượng.
⤢--slurpfile name file	Định nghĩa $name là toàn bộ nội dung của một tệp JSON.
⤢-r	In kết quả chuỗi dạng thô, không nháy và không ký tự thoát.
⤢-c	In mỗi kết quả gọn trên một dòng, không thụt lề.
⤢-n	Chạy bộ lọc một lần trên null, để dựng đầu ra từ con số không.
⤢-s	Đọc toàn bộ đầu vào vào một mảng trước khi bộ lọc chạy.
⤢-e	Đặt mã thoát từ kết quả cuối cùng, để script shell kiểm tra được kết quả.
⤢env.VAR	Giá trị của một biến môi trường, đọc bên trong bộ lọc.