diff options
| author | github-actions[bot] <github-actions[bot]@users.noreply.github.com> | 2023-07-26 04:47:01 +0000 |
|---|---|---|
| committer | github-actions[bot] <github-actions[bot]@users.noreply.github.com> | 2023-07-26 04:47:01 +0000 |
| commit | 9dd7b419712e910c12de8a8db0a94d27ad5697d4 (patch) | |
| tree | db7eb4e2b0d405604a97a255621388e2d6ad623b | |
| parent | 96d98d39e4d743caee7d35331fab3d0772d808c9 (diff) | |
Update website
| -rw-r--r-- | manual/index.html | 409 |
1 files 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.</p> </section> + <section id="abs"> + <h3> + <code>abs</code> + + </h3> + <p>The builtin function <code>abs</code> is defined naively as: <code>if . < 0 then - . else . end</code>.</p> +<p>For numeric input, this is the absolute value. See the +section on the identity filter for the implications of this +definition for numeric input.</p> +<p>To compute the absolute value of a number as a floating point number, you may wish use <code>fabs</code>.</p> + + + <div> + + <a data-toggle="collapse" href="#example16"> + <i class="glyphicon glyphicon-chevron-right"></i> + Example + </a> + <div id="example16" class="manual-example collapse"> + + <table> + <tr><th></th><td class="jqprogram">jq 'map(abs)'</td></tr> + <tr><th>Input</th><td>[-10, -1.1, -1e-1]</td></tr> + + + <tr> + + <th>Output</th> + + <td>[10,1.1,1e-1]</td> + </tr> + + </table> + + </div> + </div> + + </section> + <section id="length"> <h3> <code>length</code> @@ -1691,11 +1730,11 @@ different types of value:</p> <div> - <a data-toggle="collapse" href="#example16"> + <a data-toggle="collapse" href="#example17"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example16" class="manual-example collapse"> + <div id="example17" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '.[] | length'</td></tr> @@ -1755,11 +1794,11 @@ bytes used to encode a string in UTF-8.</p> <div> - <a data-toggle="collapse" href="#example17"> + <a data-toggle="collapse" href="#example18"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example17" class="manual-example collapse"> + <div id="example18" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'utf8bytelength'</td></tr> @@ -1801,11 +1840,11 @@ instead the keys will roughly be in insertion order.</p> <div> - <a data-toggle="collapse" href="#example18"> + <a data-toggle="collapse" href="#example19"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example18" class="manual-example collapse"> + <div id="example19" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'keys'</td></tr> @@ -1855,11 +1894,11 @@ will be faster.</p> <div> - <a data-toggle="collapse" href="#example19"> + <a data-toggle="collapse" href="#example20"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example19" class="manual-example collapse"> + <div id="example20" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'map(has("foo"))'</td></tr> @@ -1907,11 +1946,11 @@ of <code>has</code>.</p> <div> - <a data-toggle="collapse" href="#example20"> + <a data-toggle="collapse" href="#example21"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example20" class="manual-example collapse"> + <div id="example21" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '.[] | in({"foo": 42})'</td></tr> @@ -1996,11 +2035,11 @@ map_values(empty) #=> [] <div> - <a data-toggle="collapse" href="#example21"> + <a data-toggle="collapse" href="#example22"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example21" class="manual-example collapse"> + <div id="example22" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'map(.+1)'</td></tr> @@ -2076,11 +2115,11 @@ For arrays, negative indices and .[m:n] specifications should not be used.</p> <div> - <a data-toggle="collapse" href="#example22"> + <a data-toggle="collapse" href="#example23"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example22" class="manual-example collapse"> + <div id="example23" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'pick(.a, .b.c, .x)'</td></tr> @@ -2140,11 +2179,11 @@ boolean values in <code>.</code>, and only those paths.</p> <div> - <a data-toggle="collapse" href="#example23"> + <a data-toggle="collapse" href="#example24"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example23" class="manual-example collapse"> + <div id="example24" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'path(.a[0].b)'</td></tr> @@ -2190,11 +2229,11 @@ value from an object.</p> <div> - <a data-toggle="collapse" href="#example24"> + <a data-toggle="collapse" href="#example25"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example24" class="manual-example collapse"> + <div id="example25" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'del(.foo)'</td></tr> @@ -2240,11 +2279,11 @@ at each path in <code>PATHS</code>.</p> <div> - <a data-toggle="collapse" href="#example25"> + <a data-toggle="collapse" href="#example26"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example25" class="manual-example collapse"> + <div id="example26" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'getpath(["a","b"])'</td></tr> @@ -2289,11 +2328,11 @@ at each path in <code>PATHS</code>.</p> <div> - <a data-toggle="collapse" href="#example26"> + <a data-toggle="collapse" href="#example27"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example26" class="manual-example collapse"> + <div id="example27" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'setpath(["a","b"]; 1)'</td></tr> @@ -2354,11 +2393,11 @@ of strings and numbers.</p> <div> - <a data-toggle="collapse" href="#example27"> + <a data-toggle="collapse" href="#example28"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example27" class="manual-example collapse"> + <div id="example28" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'delpaths([["a","b"]])'</td></tr> @@ -2397,11 +2436,11 @@ doing some operation to all keys and values of an object. <div> - <a data-toggle="collapse" href="#example28"> + <a data-toggle="collapse" href="#example29"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example28" class="manual-example collapse"> + <div id="example29" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'to_entries'</td></tr> @@ -2464,11 +2503,11 @@ will give you <code>[2,3]</code>.</p> <div> - <a data-toggle="collapse" href="#example29"> + <a data-toggle="collapse" href="#example30"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example29" class="manual-example collapse"> + <div id="example30" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'map(select(. >= 2))'</td></tr> @@ -2516,11 +2555,11 @@ non-iterables, respectively.</p> <div> - <a data-toggle="collapse" href="#example30"> + <a data-toggle="collapse" href="#example31"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example30" class="manual-example collapse"> + <div id="example31" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '.[]|numbers'</td></tr> @@ -2552,11 +2591,11 @@ non-iterables, respectively.</p> <div> - <a data-toggle="collapse" href="#example31"> + <a data-toggle="collapse" href="#example32"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example31" class="manual-example collapse"> + <div id="example32" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '1, empty, 2'</td></tr> @@ -2613,11 +2652,11 @@ emit <code>[]</code>.</p> <div> - <a data-toggle="collapse" href="#example32"> + <a data-toggle="collapse" href="#example33"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example32" class="manual-example collapse"> + <div id="example33" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'try error catch .'</td></tr> @@ -2690,11 +2729,11 @@ values.</p> <div> - <a data-toggle="collapse" href="#example33"> + <a data-toggle="collapse" href="#example34"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example33" class="manual-example collapse"> + <div id="example34" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'try error("\($__loc__)") catch .'</td></tr> @@ -2730,11 +2769,11 @@ values.</p> <div> - <a data-toggle="collapse" href="#example34"> + <a data-toggle="collapse" href="#example35"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example34" class="manual-example collapse"> + <div id="example35" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '[paths]'</td></tr> @@ -2784,11 +2823,11 @@ as those for the <code>+</code> operator (described above).</p> <div> - <a data-toggle="collapse" href="#example35"> + <a data-toggle="collapse" href="#example36"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example35" class="manual-example collapse"> + <div id="example36" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'add'</td></tr> @@ -2854,11 +2893,11 @@ condition to all the outputs of the given generator.</p> <div> - <a data-toggle="collapse" href="#example36"> + <a data-toggle="collapse" href="#example37"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example36" class="manual-example collapse"> + <div id="example37" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'any'</td></tr> @@ -2924,11 +2963,11 @@ condition to all the outputs of the given generator.</p> <div> - <a data-toggle="collapse" href="#example37"> + <a data-toggle="collapse" href="#example38"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example37" class="manual-example collapse"> + <div id="example38" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'all'</td></tr> @@ -2992,11 +3031,11 @@ levels deep.</p> <div> - <a data-toggle="collapse" href="#example38"> + <a data-toggle="collapse" href="#example39"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example38" class="manual-example collapse"> + <div id="example39" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'flatten'</td></tr> @@ -3078,11 +3117,11 @@ with an increment of <code>by</code>.</p> <div> - <a data-toggle="collapse" href="#example39"> + <a data-toggle="collapse" href="#example40"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example39" class="manual-example collapse"> + <div id="example40" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'range(2; 4)'</td></tr> @@ -3190,11 +3229,11 @@ with an increment of <code>by</code>.</p> <div> - <a data-toggle="collapse" href="#example40"> + <a data-toggle="collapse" href="#example41"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example40" class="manual-example collapse"> + <div id="example41" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'floor'</td></tr> @@ -3225,11 +3264,11 @@ with an increment of <code>by</code>.</p> <div> - <a data-toggle="collapse" href="#example41"> + <a data-toggle="collapse" href="#example42"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example41" class="manual-example collapse"> + <div id="example42" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'sqrt'</td></tr> @@ -3262,11 +3301,11 @@ equivalent, leave numbers alone, and give an error on all other input.</p> <div> - <a data-toggle="collapse" href="#example42"> + <a data-toggle="collapse" href="#example43"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example42" class="manual-example collapse"> + <div id="example43" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '.[] | tonumber'</td></tr> @@ -3306,11 +3345,11 @@ JSON-encoded.</p> <div> - <a data-toggle="collapse" href="#example43"> + <a data-toggle="collapse" href="#example44"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example43" class="manual-example collapse"> + <div id="example44" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '.[] | tostring'</td></tr> @@ -3357,11 +3396,11 @@ or object.</p> <div> - <a data-toggle="collapse" href="#example44"> + <a data-toggle="collapse" href="#example45"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example44" class="manual-example collapse"> + <div id="example45" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'map(type)'</td></tr> @@ -3401,11 +3440,11 @@ NaNs, and sub-normals do not raise errors.</p> <div> - <a data-toggle="collapse" href="#example45"> + <a data-toggle="collapse" href="#example46"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example45" class="manual-example collapse"> + <div id="example46" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '.[] | (infinite * .) < 0'</td></tr> @@ -3484,11 +3523,11 @@ equal, and so on.</p> <div> - <a data-toggle="collapse" href="#example46"> + <a data-toggle="collapse" href="#example47"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example46" class="manual-example collapse"> + <div id="example47" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'sort'</td></tr> @@ -3553,11 +3592,11 @@ in the <code>sort</code> function above.</p> <div> - <a data-toggle="collapse" href="#example47"> + <a data-toggle="collapse" href="#example48"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example47" class="manual-example collapse"> + <div id="example48" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'group_by(.foo)'</td></tr> @@ -3591,11 +3630,11 @@ you to specify a particular field or property to examine, e.g. <div> - <a data-toggle="collapse" href="#example48"> + <a data-toggle="collapse" href="#example49"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example48" class="manual-example collapse"> + <div id="example49" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'min'</td></tr> @@ -3646,11 +3685,11 @@ produced by <code>group</code>.</p> <div> - <a data-toggle="collapse" href="#example49"> + <a data-toggle="collapse" href="#example50"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example49" class="manual-example collapse"> + <div id="example50" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'unique'</td></tr> @@ -3709,11 +3748,11 @@ produced by <code>group</code>.</p> <div> - <a data-toggle="collapse" href="#example50"> + <a data-toggle="collapse" href="#example51"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example50" class="manual-example collapse"> + <div id="example51" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'reverse'</td></tr> @@ -3751,11 +3790,11 @@ be contained in each other if they are equal.</p> <div> - <a data-toggle="collapse" href="#example51"> + <a data-toggle="collapse" href="#example52"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example51" class="manual-example collapse"> + <div id="example52" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'contains("bar")'</td></tr> @@ -3845,11 +3884,11 @@ in <code>.</code> match those of <code>s</code>.</p> <div> - <a data-toggle="collapse" href="#example52"> + <a data-toggle="collapse" href="#example53"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example52" class="manual-example collapse"> + <div id="example53" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'indices(", ")'</td></tr> @@ -3909,11 +3948,11 @@ occurrence of <code>s</code> in the input.</p> <div> - <a data-toggle="collapse" href="#example53"> + <a data-toggle="collapse" href="#example54"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example53" class="manual-example collapse"> + <div id="example54" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'index(", ")'</td></tr> @@ -4016,11 +4055,11 @@ inversed version of <code>contains</code>.</p> <div> - <a data-toggle="collapse" href="#example54"> + <a data-toggle="collapse" href="#example55"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example54" class="manual-example collapse"> + <div id="example55" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'inside("foobar")'</td></tr> @@ -4107,11 +4146,11 @@ inversed version of <code>contains</code>.</p> <div> - <a data-toggle="collapse" href="#example55"> + <a data-toggle="collapse" href="#example56"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example55" class="manual-example collapse"> + <div id="example56" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '[.[]|startswith("foo")]'</td></tr> @@ -4142,11 +4181,11 @@ inversed version of <code>contains</code>.</p> <div> - <a data-toggle="collapse" href="#example56"> + <a data-toggle="collapse" href="#example57"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example56" class="manual-example collapse"> + <div id="example57" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '[.[]|endswith("foo")]'</td></tr> @@ -4179,11 +4218,11 @@ of <code>n</code> repetitions of the input array.</p> <div> - <a data-toggle="collapse" href="#example57"> + <a data-toggle="collapse" href="#example58"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example57" class="manual-example collapse"> + <div id="example58" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'combinations'</td></tr> @@ -4271,11 +4310,11 @@ starts with it.</p> <div> - <a data-toggle="collapse" href="#example58"> + <a data-toggle="collapse" href="#example59"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example58" class="manual-example collapse"> + <div id="example59" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '[.[]|ltrimstr("foo")]'</td></tr> @@ -4307,11 +4346,11 @@ ends with it.</p> <div> - <a data-toggle="collapse" href="#example59"> + <a data-toggle="collapse" href="#example60"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example59" class="manual-example collapse"> + <div id="example60" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq '[.[]|rtrimstr("foo")]'</td></tr> @@ -4343,11 +4382,11 @@ codepoint numbers.</p> <div> - <a data-toggle="collapse" href="#example60"> + <a data-toggle="collapse" href="#example61"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example60" class="manual-example collapse"> + <div id="example61" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'explode'</td></tr> @@ -4378,11 +4417,11 @@ codepoint numbers.</p> <div> - <a data-toggle="collapse" href="#example61"> + <a data-toggle="collapse" href="#example62"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example61" class="manual-example collapse"> + <div id="example62" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'implode'</td></tr> @@ -4415,11 +4454,11 @@ two arguments (see the regular expressions section below).</p> <div> - <a data-toggle="collapse" href="#example62"> + <a data-toggle="collapse" href="#example63"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example62" class="manual-example collapse"> + <div id="example63" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'split(", ")'</td></tr> @@ -4456,11 +4495,11 @@ in the input are not supported.</p> <div> - <a data-toggle="collapse" href="#example63"> + <a data-toggle="collapse" href="#example64"> <i class="glyphicon glyphicon-chevron-right"></i> Examples </a> - <div id="example63" class="manual-example collapse"> + <div id="example64" class="manual-example collapse"> <table> <tr><th></th><td class="jqprogram">jq 'join(", ")'</td></tr> @@ -4506,11 +4545,11 @@ converted to the specified case.</p> <div> - <a data-toggle="collapse" href="#example64"> + <a data-toggle="collapse" href="#example65"> <i class="glyphicon glyphicon-chevron-right"></i> Example </a> - <div id="example64" class="manual-example collapse"> |