From 9dd7b419712e910c12de8a8db0a94d27ad5697d4 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
Date: Wed, 26 Jul 2023 04:47:01 +0000
Subject: Update website
---
manual/index.html | 409 ++++++++++++++++++++++++++++++------------------------
1 file changed, 225 insertions(+), 184 deletions(-)
diff --git a/manual/index.html b/manual/index.html
index ba1f9b22..b9497ba4 100644
--- a/manual/index.html
+++ b/manual/index.html
@@ -1658,6 +1658,45 @@ the same strategy.
+
+
+ abs
+
+
+ The builtin function abs
is defined naively as: if . < 0 then - . else . end
.
+For numeric input, this is the absolute value. See the
+section on the identity filter for the implications of this
+definition for numeric input.
+To compute the absolute value of a number as a floating point number, you may wish use fabs
.
+
+
+
+
+
+
+ Example
+
+
+
+
+ | jq 'map(abs)' |
+ Input | [-10, -1.1, -1e-1] |
+
+
+
+
+ Output |
+
+ [10,1.1,1e-1] |
+
+
+
+
+
+
+
+
+
length
@@ -1691,11 +1730,11 @@ different types of value:
-
+
Example
-
+
| jq '.[] | length' |
@@ -1755,11 +1794,11 @@ bytes used to encode a string in UTF-8.
-
+
Example
-
+
| jq 'utf8bytelength' |
@@ -1801,11 +1840,11 @@ instead the keys will roughly be in insertion order.
-
+
Examples
-
+
| jq 'keys' |
@@ -1855,11 +1894,11 @@ will be faster.
-
+
Examples
-
+
| jq 'map(has("foo"))' |
@@ -1907,11 +1946,11 @@ of has
.
-
+
Examples
-
+
| jq '.[] | in({"foo": 42})' |
@@ -1996,11 +2035,11 @@ map_values(empty) #=> []
-
+
Examples
-
+
| jq 'map(.+1)' |
@@ -2076,11 +2115,11 @@ For arrays, negative indices and .[m:n] specifications should not be used.
-
+
Examples
-
+
| jq 'pick(.a, .b.c, .x)' |
@@ -2140,11 +2179,11 @@ boolean values in .
, and only those paths.
-
+
Examples
-
+
| jq 'path(.a[0].b)' |
@@ -2190,11 +2229,11 @@ value from an object.
-
+
Examples
-
+
| jq 'del(.foo)' |
@@ -2240,11 +2279,11 @@ at each path in PATHS
.
-
+
Examples
-
+
| jq 'getpath(["a","b"])' |
@@ -2289,11 +2328,11 @@ at each path in PATHS
.
-
+
Examples
-
+
| jq 'setpath(["a","b"]; 1)' |
@@ -2354,11 +2393,11 @@ of strings and numbers.
-
+
Example
-
+
| jq 'delpaths([["a","b"]])' |
@@ -2397,11 +2436,11 @@ doing some operation to all keys and values of an object.
-
+
Examples
-
+
| jq 'to_entries' |
@@ -2464,11 +2503,11 @@ will give you [2,3]
.
-
+
Examples
-
+
| jq 'map(select(. >= 2))' |
@@ -2516,11 +2555,11 @@ non-iterables, respectively.
-
+
Example
-
+
| jq '.[]|numbers' |
@@ -2552,11 +2591,11 @@ non-iterables, respectively.
-
+
Examples
-
+
| jq '1, empty, 2' |
@@ -2613,11 +2652,11 @@ emit []
.
-
+
Examples
-
+
| jq 'try error catch .' |
@@ -2690,11 +2729,11 @@ values.
-
+
Example
-
+
| jq 'try error("\($__loc__)") catch .' |
@@ -2730,11 +2769,11 @@ values.
-
+
Examples
-
+
| jq '[paths]' |
@@ -2784,11 +2823,11 @@ as those for the +
operator (described above).
-
+
Examples
-
+
| jq 'add' |
@@ -2854,11 +2893,11 @@ condition to all the outputs of the given generator.
-
+
Examples
-
+
| jq 'any' |
@@ -2924,11 +2963,11 @@ condition to all the outputs of the given generator.
-
+
Examples
-
+
| jq 'all' |
@@ -2992,11 +3031,11 @@ levels deep.
-
+
Examples
-
+
| jq 'flatten' |
@@ -3078,11 +3117,11 @@ with an increment of by
.
-
+
Examples
-
+
| jq 'range(2; 4)' |
@@ -3190,11 +3229,11 @@ with an increment of by
.
-
+
Example
-
+
| jq 'floor' |
@@ -3225,11 +3264,11 @@ with an increment of by
.
-
+
Example
-
+
| jq 'sqrt' |
@@ -3262,11 +3301,11 @@ equivalent, leave numbers alone, and give an error on all other input.
-
+
Example
-
+
| jq '.[] | tonumber' |
@@ -3306,11 +3345,11 @@ JSON-encoded.
-
+
Example
-
+
| jq '.[] | tostring' |
@@ -3357,11 +3396,11 @@ or object.
-
+
Example
-
+
| jq 'map(type)' |
@@ -3401,11 +3440,11 @@ NaNs, and sub-normals do not raise errors.
-
+
Examples
-
+
| jq '.[] | (infinite * .) < 0' |
@@ -3484,11 +3523,11 @@ equal, and so on.
-
+
Examples
-
+
| jq 'sort' |
@@ -3553,11 +3592,11 @@ in the sort
function above.
-
+
Example
-
+
| jq 'group_by(.foo)' |
@@ -3591,11 +3630,11 @@ you to specify a particular field or property to examine, e.g.
-
+
Examples
-
+
| jq 'min' |
@@ -3646,11 +3685,11 @@ produced by group
.
-
+
Examples
-
+
| jq 'unique' |
@@ -3709,11 +3748,11 @@ produced by group
.
-
+
Example
-
+
| jq 'reverse' |
@@ -3751,11 +3790,11 @@ be contained in each other if they are equal.
-
+
Examples
-
+
| jq 'contains("bar")' |
@@ -3845,11 +3884,11 @@ in .
match those of s
.
-
+
Examples
-
+
| jq 'indices(", ")' |
@@ -3909,11 +3948,11 @@ occurrence of s
in the input.
-
+
Examples
-
+
| jq 'index(", ")' |
@@ -4016,11 +4055,11 @@ inversed version of contains
.
-
+
Examples
-
+
| jq 'inside("foobar")' |
@@ -4107,11 +4146,11 @@ inversed version of contains
.
-
+
Example
-
+
| jq '[.[]|startswith("foo")]' |
@@ -4142,11 +4181,11 @@ inversed version of contains
.
-
+
Example
-
+
| jq '[.[]|endswith("foo")]' |
@@ -4179,11 +4218,11 @@ of n
repetitions of the input array.
-
+
Examples
-
+
| jq 'combinations' |
@@ -4271,11 +4310,11 @@ starts with it.
-
+
Example
-
+
| jq '[.[]|ltrimstr("foo")]' |
@@ -4307,11 +4346,11 @@ ends with it.
-
+
Example
-
+
| jq '[.[]|rtrimstr("foo")]' |
@@ -4343,11 +4382,11 @@ codepoint numbers.
-
+
Example
-
+
| jq 'explode' |
@@ -4378,11 +4417,11 @@ codepoint numbers.
-
+
Example
-
+
| jq 'implode' |
@@ -4415,11 +4454,11 @@ two arguments (see the regular expressions section below).
-
+
Example
-
+
| jq 'split(", ")' |
@@ -4456,11 +4495,11 @@ in the input are not supported.
-
+
Examples
-
+
| jq 'join(", ")' |
@@ -4506,11 +4545,11 @@ converted to the specified case.
-
+
Example
-
+
| jq 'ascii_upcase' |
@@ -4546,11 +4585,11 @@ output for each input. See advanced topics below.
-
+
Example
-
+
| jq '[while(.<100; .*2)]' |
@@ -4586,11 +4625,11 @@ output for each input. See advanced topics below.
-
+
Example
-
+
| jq '[repeat(.*2, error)?]' |
@@ -4628,11 +4667,11 @@ output for each input. See advanced topics below.
-
+
Example
-
+
| jq '[.,1]|until(.[0] < 1; [.[0] - 1, .[1] * .[0]])|.[1]' |
@@ -4691,11 +4730,11 @@ input.
-
+
Examples
-
+
| jq 'recurse(.foo[])' |
@@ -4820,11 +4859,11 @@ input can be considered for alteration.
-
+
Examples
-
+
| jq 'walk(if type == "array" then sort else . end)' |
@@ -4873,11 +4912,11 @@ variables.
-
+
Examples
-
+
| jq '$ENV.PAGER' |
@@ -4923,11 +4962,11 @@ Rows are padded with nulls so the result is always rectangular.
-
+
Example
-
+
| jq 'transpose' |
@@ -4965,11 +5004,11 @@ interest.
-
+
Examples
-
+
| jq 'bsearch(0)' |
@@ -5030,11 +5069,11 @@ interpolated into the string.
-
+
Example
-
+
| jq '"The input was \(.), which is one less than \(.+1)"' |
@@ -5068,11 +5107,11 @@ unmodified, while tojson
encodes strings as JSON strings.
-
+
Examples
-
+
| jq '[.[]|tostring]' |
@@ -5197,11 +5236,11 @@ not escaped, as they were part of the string literal.
-
+
Examples
-
+
| jq '@html' |
@@ -5319,11 +5358,11 @@ some systems. In particular, the %u
and %j
specifiers
-
+
Examples
-
+
| jq 'fromdate' |
@@ -5452,11 +5491,11 @@ JavaScript's ===
, the "strict equality" operator.
-
+
Examples
-
+
| jq '. == false' |
@@ -5551,11 +5590,11 @@ once for each false or null.