JAQ(1)                      General Commands Manual                     JAQ(1)




<?><?><?> (NAME)
       jaq - <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> JSON



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       jaq [OPTION]<?> [FILTER] [FILE]<?>



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> jaq <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> jq <?><?><?>.  <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> jq (<?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> jq
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> C <?><?><?>)
       <?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> jaq <?><?> <?><?> <?><?><?><?> Rust <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?> <?><?> <?><?><?><?> jaq
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> jq <?><?><?><?> <?><?><?><?><?><?>:


         o <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> JSON<?> YAML<?> CBOR<?>
           TOML<?> XML


         o <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> UTF-8 <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?>


         o <?><?><?><?><?><?><?><?> <?><?><?><?><?> (Byte strings)


         o <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> {0: 1, [2]: 3}


         o <?><?><?><?><?><?><?><?> <?><?><?><?> (In-place) <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?>



       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>:


         o <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
           <?><?><?><?>.


         o <?><?><?><?> <?><?><?><?><?><?><?><?><?> jaq<?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?> jaq<?> <?><?><?><?>
           <?><?><?><?> jq <?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> jq <?><?> <?><?><?><?><?> <?><?><?>.
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> jq <https://jqlang.org/manual> <?><?>
           <?><?><?><?> <?><?><?><?><?><?>.


         o <?><?><?><?> <?><?><?><?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> jq <?> jaq <?><?>
           <?><?><?> <?><?><?>.



       <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       (issue) <https://github.com/01mf02/jaq/issues> <?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?><?>
       <?><?><?><?><?>) <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> jaq
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>.  <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>!

       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> NGI0 Commons Fund <https://nlnet.nl/commonsfund>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> NLnet <https://nlnet.nl> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> Next Generation Internet
       <https://ngi.eu> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> DG Communications Networks, Content and Technology
       <https://commission.europa.eu/about-european-commission/departments-and-executive-agencies/communications-networks-content-and-technology_en>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       101135429 <https://cordis.europa.eu/project/id/101135429>
       <?><?><?><?><?> <?><?><?> <?><?><?>.  <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?> <https://www.sbfi.admin.ch/sbfi/en/home.html> (SERI)
       <?><?><?><?><?> <?><?><?> <?><?><?>.

       <?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <<<?><?><?><?><?><?><?>>> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> jaq <?><?> jq <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?> <?><?><?> <?><?><?><?><?><?><?> <<jq>> <?><?>
              <?><?><?><?><?><?><?><?><?><?> C <?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?> <<jq>> <?><?> <?><?><?> <?><?><?><?>
              jq <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?> <?><?> <?><?><?><?><?> (COMMAND-LINE INTERFACE)
       <?><?><?><?><?> jaq [OPTION]<?> [FILTER] [FILE]<?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>:


         o <?><?><?><?><?> (parse) <?><?><?><?> FILTER <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> jq<?> <?><?><?> <?><?><?><?> jq <?><?>
           <?><?><?><?><?><?>


         o <?><?> <?><?><?><?> <?><?> FILE:


           o <?><?><?><?><?> <?><?><?><?> FILE <?><?> <?><?><?><?><?><?>
             <?><?> <?><?><?><?><?><?>


           o <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
             <?><?><?><?>:


             o <?><?><?><?><?> FILTER <?><?><?> <?><?><?><?><?>
               <?><?><?><?><?> <?> <?><?><?> <?><?><?><?><?><?>
               <?><?><?><?><?> <?><?>






         o <?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> jaq
           <?><?><?><?><?> <?><?><?><?><?><?>.



       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> jaq '.name?'
       persons.json <?><?><?><?><?> <?><?><?><?><?> .name? <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> persons.json <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.  <?><?><?>
       <?><?><?><?><?> .name? <?><?> <?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       JSON <?><?><?> <?><?><?><?><?><?>.


   <?><?><?><?><?> (INPUT)
       <?><?><?> <?><?><?> FILE <?><?><?><?> <?><?><?><?><?> jaq <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.
       <?><?><?><?><?> jaq <?><?><?><?> <?><?><?><?><?> FILE <?><?> <?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:


         o <?><?><?> <?><?><?><?><?> --from FORMAT <?><?><?><?><?><?><?>
           <?><?><?><?> jaq <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>.


         o <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> FILE
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> jaq <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           .json<?> .yaml<?> .cbor<?> .toml<?> .xml<?> .csv<?> .tsv<?>
           <?><?><?><?><?> jaq <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>.


         o <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> jaq <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> JSON <?><?><?>.




   --from FORMAT
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> FORMAT.  <?><?><?><?> <?><?><?><?><?>: jaq --from
       yaml . myfile.yml <?><?><?><?> myfile.yml <?><?> <?><?> <?><?><?><?><?>
       YAML <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> FORMAT <?><?><?><?><?><?><?> <?><?>: raw<?>
       raw0<?> json<?> yaml<?> cbor<?> toml<?> xml<?> csv<?> tsv.

       <?><?><?><?><?> jaq <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?>: .json<?> .yaml<?> .yml<?>
       .cbor<?> .toml<?> .xml<?> .xhtml<?> .csv<?> .tsv.  <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> jaq --from cbor
       . myfile.cbor <?><?><?><?><?> <?><?><?> <?><?> jaq . myfile.cbor.

       <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> jq <?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?>.




   -n, --null-input
       <?><?><?><?><?> <?><?><?><?><?> null <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?>:

              $ yes | jaq -n
              null


       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> inputs <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?>:

              $ yes true | jaq -n 'first(inputs)'
              true


       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       reduce / foreach <?><?><?><?> <?><?><?><?>.



   -R, --raw-input
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>:

              $ printf "Hello\nWorld" | jaq -R
              "Hello"
              "World"


       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> --slurp
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:

              $ printf "Hello\nWorld" | jaq -Rs
              "Hello\nWorld"


       <?><?><?><?><?> --rawfile <?><?> <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> --from raw <?><?><?>.



   --raw-input0
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> --raw-input<?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> NUL (\0) <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:

              $ printf "Hello\nWorld\0foo" | jaq --raw-input0
              "Hello\nWorld"
              "foo"


       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> --slurp
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>:

              $ printf "Hello\nWorld\0foo" | jaq -sc --raw-input0
              ["Hello\nWorld","foo"]


       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       --raw-output0 <?><?><?><?><?><?><?> <?><?><?>:

              $ printf '"some string\\nwith a newline" "another string"' | jaq --raw-output0 | jaq --raw-input0
              "some string\nwith a newline"
              "another string"


       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> --from raw0 <?><?><?>.

       <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> jq <?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?>.




   -s, --slurp
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> (<?><?> <?><?><?><?> <?><?>
       <?><?><?><?>).  <?><?><?><?> <?><?><?><?><?>:

              $ echo 1 2 3 | jaq
              1
              2
              3
              $ echo 1 2 3 | jaq -cs
              [1,2,3]


       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> --raw-input
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> jaq <?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:

              $ echo 1 2 3 | jaq -Rs
              "1 2 3\n"


       <?><?><?><?><?> --rawfile <?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              slurp <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> jq <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> jaq <?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> --in-place <?><?> jaq
              <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?> jq <?><?><?> <?><?><?>.  <?><?><?><?><?> jq <?><?> jaq
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> jq -s . a b<?>
              <?><?><?><?><?><?><?><?><?> <?><?> jaq -s . <(cat a b)
              <?><?><?><?><?><?><?> <?><?><?><?>.





   <?><?><?><?><?> (OUTPUT)
   --to FORMAT
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> FORMAT <?><?><?><?><?><?><?><?>.  <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> --from <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       <?><?> TOML <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> (object) <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> TOML <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>:

              $ echo [] | jaq --to toml 2>/dev/null; echo $?
              2


       <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> jq <?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?>.




   -c, --compact-output
       <?><?><?> <?><?><?><?><?> JSON <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?>:

              $ echo [1, 2, 3] | jaq -c
              [1,2,3]




   -r, --raw-output
       <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?> <?>
       <?><?><?><?><?>) <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> (<?><?><?><?><?><?>).  <?><?><?><?> <?><?><?><?><?>:

              $ printf '"Hello\\nWorld"' | jaq -r
              Hello
              World
              $ printf '"Hello\\nWorld"' | jaq
              "Hello\nWorld"


       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:

              $ printf '["Hello\\nWorld"]' | jaq -rc
              ["Hello\nWorld"]


       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> --to raw <?><?><?>.



   --raw-output0
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       --raw-output<?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> NUL (\0) <?><?> <?><?><?>
       LF (\n).

              $ printf '"some string\\nwith a newline" true' | jaq --raw-output0 | jaq -s --raw-input tobytes
              b"some string\nwith a newline\x00true\x00"


       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?> NUL <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?>.

              $ printf '"string with NUL \\u0000"' | jaq --raw-output0 2>/dev/null; echo $?
              2


       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> --to raw0 <?><?><?>.



   -j, --join-output
       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:

              $ echo true false | jaq -j && echo " (no new line at end)"
              truefalse (no new line at end)


       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> --raw-output (-r) <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>:

              $ printf '"Hello" " " "World" "\\n"' | jaq -jr
              Hello World




   -i, --in-place
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> (in-place).
       <?><?><?><?> <?><?><?><?><?>:

              $ echo 1 > tmp.json && jaq -i '.+1' tmp.json && cat tmp.json && rm tmp.json
              2


       <?><?><?> <?><?><?><?><?> <?><?><?><?> tmp.json <?><?>
       <?><?><?><?><?><?> <?> <?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> .+1 <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> jq <?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?>.





   -S, --sort-keys
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>:

              $ echo '{"b": {"d": 3, "c": 2}, "a": 1}' | jaq -cS
              {"a":1,"b":{"c":2,"d":3}}
              $ echo '{"b": {"d": 3, "c": 2}, "a": 1}' | jaq -c
              {"b":{"d":3,"c":2},"a":1}




   -C, --color-output
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?> jaq <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:

              $ echo {} | jaq -C | jaq --from raw tobytes
              b"\x1b[1;39m{\x1b[0m\x1b[1;39m}\x1b[0m"
              $ echo {} | jaq    | jaq --from raw tobytes
              b"{}"


       (<?><?> <?><?><?><?><?><?> jaq --from raw tobytes <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> -C <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> ANSI <?><?><?>.)



   -M, --monochrome-output
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?>
       (<?><?><?><?><?> <?><?><?><?><?><?>).



   --tab
       <?><?><?><?><?><?><?> <?><?> <?><?> (tab) <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       (spaces).

       <?><?><?><?> <?><?><?><?><?>:

              $ echo [1, [2]] | jaq --tab | jaq -Rs
              "[\n\t1,\n\t[\n\t\t2\n\t]\n]\n"
              $ echo [1, [2]] | jaq       | jaq -Rs
              "[\n  1,\n  [\n    2\n  ]\n]\n"




   --indent N
       <?><?><?><?><?><?><?> <?><?> N <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?><?><?><?><?><?>: 2).



   NO_COLOR
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> NO_COLOR <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> jaq <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> -C
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>.



   JQ_COLORS
       <?><?><?><?><?> <?><?><?><?><?> JQ_COLORS <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> (colon) <?><?><?> <?><?>
       <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?> JQ_COLORS <?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>:


         o null


         o false


         o true


         o <?><?><?><?><?> (numbers)


         o <?><?><?><?><?><?><?> (strings)


         o <?><?><?><?><?><?><?><?> (arrays)


         o <?><?><?><?><?> (objects)


         o <?><?><?><?><?><?><?> <?><?><?><?><?> (object keys)



       <?><?><?> JQ_COLORS <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       90:39:39:39:32:1;39:1;39:1;34 <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?>:


         o <?><?><?><?><?> null <?><?><?><?><?> <?><?><?> 90 <?><?><?>
           (<?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>).


         o <?><?><?><?><?><?> false/true/<?><?><?><?><?> <?><?><?><?><?>
           <?><?><?> 39 <?><?><?><?><?> (<?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?>).


         o <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> 32 <?><?><?><?><?>
           (<?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>).


         o <?><?><?><?><?><?><?><?>/<?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           1;39 <?><?><?><?><?> (<?><?><?><?><?> <?> <?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>).


         o <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
           1;34 <?><?><?><?><?> (<?><?><?><?><?> <?> <?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?>).



       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> JQ_COLORS<?>
       <?><?><?><?><?> 90 <?><?> 1;39<?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <<Select Graphic Rendition>>
       <https://en.wikipedia.org/wiki/ANSI_escape_code#Select_Graphic_Rendition_parameters>
       (SGR) <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>:


         o 32 <?><?> \x1b[32m <?><?><?><?><?> <?><?><?><?><?><?>.


         o 1;39 <?><?> \x1b[1;39m <?><?><?><?><?> <?><?><?><?><?><?>.



       <?><?><?><?><?> jaq <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> jq <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?>.




   <?><?><?><?><?><?><?> (COMPILATION)
       <?><?><?> <?><?><?> FILTER <?><?><?><?><?> <?><?><?><?><?> jaq <?><?> .
       (<?><?><?><?><?> <?><?><?><?><?>) <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       FILTER <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       (escape) <?><?><?>.  <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> (') <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> ' <?><?>
       <?><?><?><?><?><?><?> <?><?> '\'' <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> "'" <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:

              $ jaq -n '"'\''"'
              "'"


       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> jaq '-1'<?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> - <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?>.  <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> -- <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?>:

              $ jaq -n -- '-1'
              -1
              $ jaq -n '(-1)'
              -1



   -f, --from-file
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?>.

       <?><?> <?><?><?> <?><?><?><?><?><?> jaq <?><?><?><?><?><?><?> FILTER
       <?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>:

              $ echo '2 * 21' > tmp.jq && jaq --from-file -n tmp.jq && rm tmp.jq
              42




   -L, --library-path DIR
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.

       <?><?><?><?><?> jaq <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?> <<<?><?><?><?><?><?><?> <?><?><?><?><?>>>
       <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?><?><?> <?><?>
       --library-path <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?>: jaq -L . -L .. 'include "script"; foo'
       <?><?><?><?> script.jq <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> --library-path <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:


         o ~/.jq


         o $ORIGIN/../lib/jq


         o $ORIGIN/../lib



       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>.




   <?><?><?><?><?><?><?> (VARIABLES)
   --arg A V
       <?><?><?><?><?> <?><?><?><?><?> $A <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> V.

       <?><?><?><?> <?><?><?><?><?>:

              $ jaq --arg name "John Doe" -n '"Welcome, " + $name'
              "Welcome, John Doe"




   --argjson A V
       <?><?><?><?><?> <?><?><?><?><?> $A <?><?> <?><?><?><?><?> JSON <?><?>
       <?><?><?> V.

       <?><?><?><?> <?><?><?><?><?>:

              $ jaq --argjson song '{"name": "One of Us", "artist": "ABBA", "year": 1981}' -n \
                '"Currently playing: \($song.name) (\($song.year))"'
              "Currently playing: One of Us (1981)"


       <?><?><?> V <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> 1 2<?> <?><?><?><?><?>
       jaq <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.



   --slurpfile A F
       <?><?><?><?><?> <?><?><?><?><?> $A <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> JSON <?><?> <?><?><?><?> F.

       <?><?><?><?> <?><?><?><?><?>:

              $ echo 1 2 3 > tmp.json && jaq --slurpfile xs tmp.json -cn '$xs' && rm tmp.json
              [1,2,3]




   --rawfile A F
       <?><?><?><?><?> <?><?><?><?><?> $A <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> F.

       <?><?><?><?><?> jaq <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (memory mapping)
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?>.  <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> jaq <?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> -Rs (--raw-input <?> --slurp) <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> (<?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>) <?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> jq<?> <?><?><?><?><?> jaq <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> UTF-8
              <?><?><?><?><?> <?><?><?> <?><?> <?><?><?>.  <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> tobytes <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?>.




   --args
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> $ARGS.positional.

       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> $ARGS.positional
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?>:

              $ touch tmp.json && jaq '$ARGS.positional' tmp.json --args foo -nc bar -- baz -j qux && rm tmp.json
              ["foo","bar","baz","-j","qux"]


       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> tmp.json <?> -nc <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> -- <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?> --args
       <?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.  <?><?> <?><?><?>
       <?><?><?><?> -j <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> -- <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>.




   <?><?><?><?><?><?> (MISCELLANEA)
   -e, --exit-status
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> 1 <?> 4 <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       <?><?><?><?><?> jaq <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>:


         o 0: <?><?><?><?> <?><?><?>.


         o 1: <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> false <?><?>
           null <?><?><?>.


         o 2: <?><?><?><?> I/O <?><?> CLI<?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> CLI.


         o 3: <?><?><?><?> <?><?><?><?><?>/<?><?><?><?><?><?><?>
           <?><?><?><?><?>.


         o 4: <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.


         o 5: <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> error.



       <?><?><?><?><?><?><?><?> halt <?> halt_error
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> jaq <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?>:

              $ jaq -n empty; echo $?
              0
              $ jaq -n false >/dev/null; echo $?
              0
              $ jaq -en false >/dev/null; echo $?
              1
              $ jaq . does_not_exist.json 2>/dev/null; echo $?
              2
              $ jaq --foo 2>/dev/null; echo $?
              2
              $ jaq '+' 2>/dev/null; echo $?
              3
              $ jaq -en empty; echo $?
              4
              $ jaq -n error 2>/dev/null; echo $?
              5
              $ jaq -n 'halt(9)'; echo $?
              9




   -h, --help
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?>.



   -V, --version
       <?><?><?> <?><?><?><?> jaq.




   <?><?><?><?><?><?><?><?><?><?><?><?><?> (UNSUPPORTED)
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> jq <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?> jaq <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>:


         o --ascii-output, -a


         o --unbuffered


         o --stream


         o --stream-errors


         o --seq


         o --jsonargs


<?><?><?><?> <?><?><?><?> (CORE LANGUAGE)
       <?><?><?><?> jq <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> (streaming) <?> <?><?><?><?><?><?><?> (lazy)
       <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> (Stephen Dolan) <?><?><?><?><?> <?><?>.  <?><?><?><?>
       jq <?><?><?><?><?><?>-<?><?><?><?> <?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?> <?><?><?>.  <?><?><?><?><?><?><?><?><?><?>
       jq <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> jq<?> gojq<?> fq <?> jaq.

       <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> jq
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> jq
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?><?><?><?> <?><?> f <?> g
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> jq <?><?>
       <?><?><?><?><?> repeat("Hi") <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> "Hi"
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?> jq <?><?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?> <?><?> <?><?><?><?> 1 +
       2, true or false --> 3 true <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?> <?><?>:

              $ jaq -n '1 + 2, true or false'
              3
              true


       <?><?> <?><?><?><?><?> <?><?><?><?><?> (atomic) <?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> (binary
       operator) <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> -1<?> map(.+1) <?> .[0] <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> 1 + 2<?> explode | .[] <?> .[0] += 1
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> f <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> (f).


   <?><?><?><?><?><?> (VALUES)
       <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?> jq
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?>
              <?><?><?><?><?> jaq <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?> jq <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.  <?><?> <?><?><?><?> <?><?> jq
              <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> JSON
              <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> jaq <?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> XJON
              <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?><?> <?><?> JSON <?><?><?>.
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> jaq <?><?><?><?><?><?>.



   null
       <?><?><?><?><?> null <?><?><?><?><?> null <?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.

       <?><?><?><?><?> null <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>: [] | .[0]
       --> null <?><?> {} | .a   --> null.



   <?><?><?><?><?><?><?> (Booleans)
       <?><?><?><?><?><?><?><?> true <?> false <?><?><?><?><?><?> <?><?><?><?>
       true <?> false <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>: 0  ==  0
       --> true <?><?> [] == {} --> false.

       <?><?> <?><?><?><?><?> jq <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> null <?> false <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> false <?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> true
       <?><?><?><?><?>.  <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> if-then-else <?> //
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.




   <?><?><?><?><?> (Numbers)
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>: 0
       --> 0<?> 3.14 --> 3.14 <?> 2.99e6 --> 2.99e6.  <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?>: -1 --> -1.

       <?><?> <?><?><?> <?><?><?><?><?><?> jaq <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> (integers)<?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       (floats) <?> <?><?><?><?><?> <?><?><?><?><?><?> (decimals)
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>:


         o <?><?> <?><?><?> <?><?><?><?> <?><?><?><?> (.) <?> <?><?><?><?>
           <?><?><?><?> (e/E) <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?> jaq
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?>: 340282366920938463463374607431768211456 (2^128).


         o <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?>.  <?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?> jaq <?><?> <?><?><?><?>
           <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           1.0e500<?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
           JSON <?><?> <?><?><?><?><?> jq <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?>.


         o <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> jaq <?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> IEEE-754
           <https://en.wikipedia.org/wiki/IEEE_754> <?><?><?><?><?>
           <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?> 1.0e500 + 1
           --> Infinity<?> <?><?><?><?> jaq <?><?><?> 1.0e500 <?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> Infinity <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?>.



       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> jaq <?><?> <?><?><?>
       <?><?><?> <?><?><?>:


         o <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>: 1
           + 2 --> 3.


         o <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>: 10 / 2 --> 5.0
           <?> 1.0 + 2 --> 3.0.



       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
       0.0<?> <?><?><?> <?><?> 1.0 <?><?> <?><?><?><?><?> <?><?> 1.
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> round<?>
       floor <?><?> ceil <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>: 1.2 | floor, round, ceil
       --> 1 1 2.

       <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> jq <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?> <?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              jaq<?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?>.  <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?>.  <?><?><?><?>
              <?><?><?><?><?>: [0, 1, 2] | .[1] --> 1<?> <?><?> <?><?><?><?>
              <?><?> [0, 1, 2] | .[1.0000000000000001] <?><?> jaq <?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> jq
              <?><?> <?><?><?><?><?> 1 <?><?><?><?><?><?>.

              <?><?><?><?><?> <?><?> <?><?><?><?> jq <?><?><?><?><?> NaN
              <?><?> <?><?> <?><?><?><?> null <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> nan | tojson <?><?><?><?><?> null
              <?><?><?><?><?><?>.  <?><?> <?><?><?><?><?><?> jaq
              <?><?><?><?><?> NaN <?><?> <?><?> <?><?><?><?><?> NaN <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> nan | tojson
              --> "NaN".  <?><?><?> XJON <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>.





   <?><?><?><?><?><?><?><?> <?><?><?><?> (Text strings)
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> "..." <?><?><?><?><?> <?><?><?>.  <?><?> <?><?><?><?><?><?>
       ... <?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       UTF-8 <?><?> <?><?><?><?><?><?> U+0020 <?><?> U+10FFFF <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> '"' <?> '\'.  <?><?><?><?>
       <?><?><?><?><?>: "Hello <?><?>!" --> "Hello <?><?>!".

       <?><?><?><?><?> <?><?> <?><?><?><?> ... <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?>:


         o \b<?> \f<?> \n<?> \r<?> <?><?> \t


         o \" <?><?> \\


         o \uHHHH <?><?> <?><?> <?><?> HHHH <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?>


         o \(f) <?><?> <?><?> <?><?> f <?><?> <?><?><?><?><?> jq <?><?><?>
           (<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> / string
           interpolation)



       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?> U+0020
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>: "NUL = \u0000" --> "NUL = \u0000".

       <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       "...\(f)..."<?> <?><?><?><?><?> <?><?><?> <?><?>: "..." + (f |
       tostring) + "...".  <?><?><?><?> <?><?><?><?><?>:


         o "Hello \("Alice", "Bob") <?>!\n" --> "Hello Alice <?>!\n" "Hello
           Bob <?>!\n"


         o 41 | "The successor of \(.) is \(.+1)." --> "The successor of 41 is
           42.".



       <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       (identifier-like) <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> [a-zA-Z_][a-zA-Z_0-9]* <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> @x <?><?><?><?><?> <?><?> <?><?> <?><?> x <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> @uri.  <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> tostring
       <?><?> <?><?><?><?> @x <?><?><?><?><?><?><?><?> (pipe)
       <?><?><?><?><?><?><?><?> <?><?><?><?>: @x "...\(f)..." <?><?><?><?><?>
       <?><?><?> <?><?> @x "..." + (f | @x) + @x "...".  <?><?><?><?><?><?>
       <?><?> "..." <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> @x
       "..." <?><?><?><?><?> <?><?> "..." <?><?><?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?>: "-[]?" | @uri
       "https://gedenkt.at/jaq/?q=\(.)" -->
       "https://gedenkt.at/jaq/?q=-%5B%5D%3F".



   <?><?><?><?><?><?><?><?> <?><?><?><?><?> (Byte strings)
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?>
       (UTF-8) <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> tobytes
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>: "Hello,
       world! <?>" | tobytes --> b"Hello, world! \xf0\x9f\x99\x82".  <?><?>
       <?><?><?> <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> jaq <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       (slicing) <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> jaq <?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?> <?><?> "Hello" |
       isstring and (tobytes | isstring) --> true.  <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>: "Hello" | . ==
       tobytes --> true.

       <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> jq <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?> fq <?><?><?><?>
              <?><?><?><?><?>.





   <?><?><?><?><?><?><?><?> (Arrays)
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?>.

       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> [] <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> [empty] --> [] <?><?><?>.  <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> [f]
       <?><?><?><?><?> <?><?> <?><?> <?><?> f <?><?> <?><?><?><?><?>
       <?><?><?>.  <?><?><?><?><?> [f] <?><?><?><?><?> <?><?><?> <?><?> <?><?>
       f <?><?><?> <?><?><?><?> <?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> f <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?>.  <?><?><?> f <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> [f] <?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>.

       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> [1, 2, 3] --> [1, 2, 3]
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?> <?><?><?><?><?><?>
       1, 2, 3 <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?>).  <?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> [x1, ..., xn]
       <?><?><?><?> <?><?><?><?><?>.  <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> [f]
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>:
       [limit(3; repeat(0))] --> [0, 0, 0].  <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> [f] <?><?>
       <?><?><?><?> f <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>:
       {count: 3, elem: 0} | [limit(.count; repeat(.elem))] --> [0, 0, 0].



   <?><?><?><?><?> (Objects)
       <?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?>.

       <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> {} <?><?><?><?>.  <?><?> <?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> {(k): v} <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?> k <?>
       v <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>: {("a"): 1} --> { "a": 1 }.

       <?><?><?> k <?><?> <?><?><?><?> <?><?><?><?><?> "a" <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> $k <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> {"a": 1} <?><?> {$k: 1}.  <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> {a: 1}.

       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?>-<?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>: {(k1): v1} + ... + {(kn): vn}.
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>: {(k1): v1,
       ..., (kn): vn}.  <?><?><?><?> <?><?><?><?><?>: {a: 1, b: 2} --> { "a":
       1, "b": 2 }.

       <?><?> <?><?><?> {k: .k} (<?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?>)<?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> {k}<?> <?><?><?><?>
       <?><?><?><?><?>: {a: 1, b: 2} | {a} --> { "a": 1 }.  <?><?><?><?><?><?>
       <?><?> <?><?><?> {k: $k}<?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> {$k}<?> <?><?><?><?> <?><?><?><?><?>: 1 as $k |
       {$k} --> { "k": 1 }.

       <?><?><?><?><?> {(k): v} <?><?><?><?><?> <?><?> k as $k | v as $v |
       {$k: $v} <?><?><?>.  <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?> k <?><?> v <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>:
       {("a", "b"): (1, 2)} --> { "a": 1 } { "a": 2 } { "b": 1 } { "b": 2 }.
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> 1, 2 <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?> , <?><?> <?><?><?>
       <?><?><?><?>-<?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?>
              <?><?> jq<?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> jaq<?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>.  <?><?>
              <?><?><?><?> <?><?> <?><?> jaq <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>:

                     {(0): 1, "2": 3, ([4]): 5, ({}): 6} -->
                     { 0 : 1, "2": 3,  [4] : 5,  {} : 6}


              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> jq<?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?> XJON <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

              <?><?><?> <?><?><?><?><?> <?><?> jq <?><?><?>
              <?><?><?><?><?><?>.





   <?><?><?><?><?><?><?><?> <?><?><?><?> (PATH OPERATORS)
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> jq
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.


   <?><?><?><?><?><?><?><?><?><?><?><?> (.[x])
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> .[x] <?><?><?><?>
       x-<?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?>:


         o [1, 2, 3] | .[1] --> 2


         o {a: 1, b: 2} | .["a"] --> 1



       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> x <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> null <?><?><?><?><?><?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?>:


         o [1, 2, 3] | .[3] --> null


         o {a: 1, b: 2} | .["c"] --> null


         o null | .[0] --> null



       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> 0 <?><?> 256 <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?>: "@ABC" | tobytes | .[0] --> 64<?>
       <?><?><?><?> <?><?><?><?><?><?><?> '@' <?><?> UTF-8 <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> 64 (0x40) <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> name<?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> .name <?><?> <?><?> <?><?><?> .["name"]
       <?><?><?><?><?><?><?><?> <?><?><?><?><?>: {a: 1} | .a --> 1.  <?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?>: {if: 1} | .if --> 1.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:
       [1, 2, 3] | .[-1] --> 3.

       <?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?> x <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       indices(x) <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?>: [1, 2, 0, 1, 2] | .[[1, 2]] --> [0, 3].

       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> (slicing)
       .[x.start : x.end] <?><?><?>.  <?><?><?><?> <?><?><?><?><?>:


         o [1, 2, 3] | .[{start: 1         }] --> [2, 3]


         o [1, 2, 3] | .[{          end: -1}] --> [1, 2]


         o [1, 2, 3] | .[{start: 1, end: -1}] --> [2]


         o [1, 2, 3] | .[{                 }] --> [1, 2, 3]



       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>:


         o <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           (<?><?><?><?><?><?><?>)<?>


         o <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?>


         o <?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?>


         o <?><?><?><?><?> null <?><?> <?><?> <?><?><?> <?><?><?><?>.



       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> jq <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>: [1, 2] | .[1.5] <?><?><?><?><?> 2
              <?><?><?><?><?><?>.  <?><?> jaq<?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?><?><?><?> jq <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> start <?><?> end <?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> jaq <?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> {start: null, end: null} <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.




   <?><?><?><?><?><?><?> (.[x:y])
       <?><?><?><?><?> <?><?><?><?><?><?><?> .[x:y] <?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       x-<?><?> <?><?> <?><?><?><?> y-<?><?> (<?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> y) <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>: [1, 2, 3] | .[1:3] --> [2, 3] <?> "Hello World!" |
       .[6:11] --> "World".

       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> x-<?><?> <?><?> x-<?><?><?><?>
       <?><?><?><?><?><?><?> UTF-8 <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?>: "<?><?>" | .[1:2] --> "<?>".  <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> x-<?><?> <?><?>
       x-<?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?>: "Farber" | tobytes, . | .[2:] | [.,
       length] --> [b"\xa4rber", 5] ["rber", 4]<?> <?><?><?><?> <?><?><?> 'a'
       <?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> .[x:] <?><?><?><?> <?><?> <?><?><?><?><?><?>
       x <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?> <?><?><?><?><?> .[:y] <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> y (<?><?><?><?><?><?><?>) <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?><?> <?><?> x <?><?><?><?><?> <?><?>
       null <?><?><?><?><?> <?><?> <?><?><?><?><?> 0 <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?> y <?><?><?><?><?>
       <?><?> null <?><?><?><?><?> <?><?> <?><?><?><?><?> length
       <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?> <?><?>
       .[x:] <?><?><?><?><?> .[x:null] <?> .[:y] <?><?><?><?><?> .[null:y]
       <?><?><?>.  <?><?><?><?> <?><?><?><?><?>:


         o "Hello World!" | .[    :5], .[6:    ] --> "Hello" "World!"


         o "Hello World!" | .[null:5], .[6:null] --> "Hello" "World!"


         o "Hello World!" | .[null    :    null] --> "Hello World!"



       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?> x <?> y <?><?> <?><?> null <?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?>.  <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?>:


         o [] | try .["a":] catch "fail" --> "fail"


         o {} | try .[1:-1] catch "fail" --> "fail"



       <?><?><?><?><?><?><?>
              <?><?><?><?><?> jaq <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?> null <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?>: null | try .[1:] catch
              "fail" --> "fail"<?> <?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?> jq <?><?><?><?><?> null
              <?><?><?><?><?><?><?><?><?><?><?>.




   <?><?><?><?><?><?> / <?><?><?><?><?> (.[])
       <?><?><?><?><?> <?><?><?><?><?><?> .[] <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> [v1, ..., vn] <?><?> <?><?><?> {k1: v1, ..., kn: vn}
       <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       v1 ... vn <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>: [1, 2, 3] | .[] --> 1 2 3 <?> {a: 1, b: 2} | .[] --> 1
       2.




   <?><?><?><?><?><?><?> <?><?><?><?><?><?> (Compound paths)
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.  <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> (compound path)
       <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> explode.[] <?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> explode | .[] <?><?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> .
       (<?><?><?><?><?>) <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>:


         o {a: [{b: 1}]} | . | .a | .[] | .b --> 1


         o {a: [{b: 1}]} | .   .a   .[]   .b --> 1


         o {a: [{b: 1}]} |     .a   .[]   .b --> 1


         o {a: [{b: 1}]}       .a   .[]   .b --> 1



       <?><?><?><?><?><?><?><?><?> . <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?>
       .[...] <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> . <?><?><?>
       <?><?><?> <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>:


         o [[[1, 2, 3]]] | .[0] | .[] | .[:-1] --> [1, 2]


         o [[[1, 2, 3]]] | .[0]   .[]   .[:-1] --> [1, 2]


         o [[[1, 2, 3]]] | .[0]    []    [:-1] --> [1, 2]


         o [[[1, 2, 3]]]    [0]    []    [:-1] --> [1, 2]



       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?> <?><?> <?><?> ?
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       .[] <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?>
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?> .[]?
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?> <?><?>
       <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?>:


         o [1, {a:  2 }, {a:  3 }] | .[].a? --> 2 3


         o [1, [2,  3 ], [4,  5 ]] | .[][]? --> 2 3 4 5


         o  1, {a: [2]}, {a: [3]}  | .a?[]  --> 2 3






   <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> (NULLARY)
   <?><?><?><?><?> (.)
       <?><?><?><?><?> <?><?><?><?><?> . <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>: 1 --> 1.



   <?><?><?><?><?><?> (..)
       <?><?><?><?><?> <?><?><?><?><?><?><?> .. <?><?><?><?><?> <?><?><?> <?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> recurse <?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>: [1, [2]] | .. --> [1, [2]] 1 [2] 2 <?> {a: {b: 1}} |
       .. --> { "a": { "b": 1 } } { "b": 1 } 1.





   <?><?><?><?><?><?><?><?> <?><?><?><?><?> (UNARY)
   <?><?><?> (-)
       <?><?><?><?><?> <?><?><?> -f <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> f <?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>: 1 | -
       . --> -1.



   <?><?><?><?><?><?><?><?> <?><?><?> (?)
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> f? <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> f <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> f <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> try f catch empty <?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>: 1 | .a? -->  (<?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>).





   <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> (BINARY
       (COMPLEX))
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.



   <?><?><?><?><?> / <?><?><?><?><?><?><?><?> (|)
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> f | g <?><?><?><?><?> <?><?>
       <?><?> f <?><?><?><?><?><?><?> <?> <?><?><?> <?><?> <?><?><?><?><?> f
       <?><?> <?><?> <?><?><?><?> <?><?><?> <?><?> g <?><?><?><?><?><?>.
       <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> g <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:
       [1, 2] | .[] | . + 1 --> 2 3.



   <?><?><?><?><?> (,)
       <?><?><?><?><?> <?><?><?><?><?> f, g <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> f <?> g
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> f
       <?> <?><?><?> <?><?><?><?><?><?><?><?><?> g <?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>: 1 |
       ., . + 1 --> 1 2.



   <?><?><?><?><?> <?><?><?><?><?> (as $x |)
       <?><?><?><?><?> f as $x | g <?><?><?><?><?> f <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> f<?> <?><?><?><?><?> $x <?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?> <?><?><?> g <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>: 1 | (2, 3) as $x | .
       + $x --> 3 4.



   <?><?><?><?><?><?> <?><?><?><?> (=)
       <?><?><?><?><?> <?><?><?><?><?><?> p = f <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> p <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> f <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>: {a: 1} | .a = 2 -->
       { "a": 2 }.  <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>.



   <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (|=)
       <?><?><?><?><?> p |= f <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> p <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> f
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>: {a: 1} | .a |= . + 1 --> { "a": 2 }.



   <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> (+=<?> -=<?> <?>)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?> p o= f <?><?><?><?><?> <?><?><?><?><?> p |= . o f
       <?><?><?><?><?>.  <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?>: +=<?> -=<?> *=<?> /=<?> %= <?> //=.
       <?><?><?><?> <?><?><?><?><?>: {a: 1} | .a += 2 --> { "a": 3 }.



   <?><?><?><?><?> (//)
       <?><?><?><?><?> <?><?><?><?><?> f // g <?><?><?><?><?> f <?><?>
       <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> f <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> true (<?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?> false <?><?> null) <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> f
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> g
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>: null // 1 --> 1 <?> false // 2 --> 2 <?> 1 // 2 --> 1.



   <?><?><?><?> (or<?> and)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> f or g <?> f and g
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>: true or false -->
       true <?> true and false --> false.





   <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> (BINARY (SIMPLE))
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.



   <?><?><?><?><?> (==<?> !=)
       <?><?><?><?><?> f == g <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> f
       <?> g <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>.
       <?><?><?><?><?> f != g <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>: 1 == 1 --> true <?>
       1 != 2 --> true.



   <?><?><?><?><?> <?> <?><?><?><?><?><?> (<<?> ><?> <=<?> >=)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> jq <?><?> <?><?><?><?> <?><?><?> <?><?><?>: null <
       false < true < <?><?><?><?><?> < <?><?><?><?><?><?><?> <
       <?><?><?><?><?><?><?><?> < <?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>: 1 < 2 --> true <?> null < 0 --> true <?> true < "a"
       --> true.



   <?><?><?> <?> <?><?><?><?><?> (+<?> -)
       <?><?><?><?><?><?><?><?> + <?> - <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?>:


         o <?><?><?><?><?>: 1 + 2 --> 3


         o <?><?><?><?><?><?><?><?>: [1] + [2] --> [1, 2]


         o <?><?><?><?><?><?><?>: "a" + "b" --> "ab"


         o <?><?><?><?><?>: {a: 1} + {b: 2} --> { "a": 1, "b": 2 }




   <?><?><?> <?> <?><?><?><?><?> (*<?> /)
       <?><?><?><?><?> * <?><?><?><?> <?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?> /
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?>
       (split) <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?>:


         o <?><?><?> <?><?><?><?><?>: 2 * 3 --> 6


         o <?><?><?><?><?> <?><?><?><?><?>: 6 / 2 --> 3.0


         o <?><?><?><?><?> <?><?><?><?>: "a,b" / "," --> ["a", "b"]




   <?><?><?><?><?><?><?><?><?> (%)
       <?><?><?><?><?> f % g <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>: 10 % 3 --> 1.





   <?><?><?><?><?> <?><?><?><?><?> (KEYWORDS)
   if-then-else
       <?><?><?><?><?> <?><?><?><?> if p then f else g end <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> p <?><?> <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> true
       <?><?><?><?> <?><?><?><?> then<?> <?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> else <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> elif <?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?>: if 1 > 0 then "yes" else "no" end -->
       "yes".



   try-catch
       <?><?><?><?><?> try f catch g <?><?><?><?><?> f <?><?> <?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> f <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?> <?><?><?><?> catch
       <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> catch <?><?><?><?><?><?><?>
       <?><?><?> (<?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>).  <?><?><?><?>
       <?><?><?><?><?>: try error("oops") catch . --> "oops".



   label-break
       <?><?><?><?><?><?> label $out | ... break $out ... <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>: label $out | 1, 2,
       break $out, 3 --> 1 2.



   reduce / foreach
       <?><?><?><?><?> reduce f as $x (init; update) <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> f
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> init <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?> <?><?> <?><?> <?><?><?><?> <?><?> update
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?>
       <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.  <?><?><?><?><?> foreach f as $x
       (init; update; extract) <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?>: reduce (1, 2, 3) as $x (0; . + $x) --> 6.



   def
       <?><?><?><?> <?><?><?><?><?> def <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?> def name(args): body;
       <?><?><?>.  <?><?><?><?> <?><?><?><?><?>: def add_one: . + 1; 5 |
       add_one --> 6.

<?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (STANDARD LIBRARY)
       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> jq <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?> <?><?><?><?><?>>> (builtins) <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>.


   <?><?><?><?><?> <?><?><?><?> (BASIC)
   error, error(f)
       <?><?><?><?><?> error(f) <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> f
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?><?> error <?><?><?><?><?> <?><?>
       error(.) <?><?><?>.  <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> error(f) <?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?><?>:


         o error(empty) --> (no output)


         o try error(41)       catch (. + 1) --> 42


         o try (41 | error   ) catch (. + 1) --> 42


         o try (error(41) = 1) catch (. + 1) --> 42





   length
       <?><?><?><?><?> <?><?><?><?><?> length <?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?>:


         o <?><?><?><?><?> null: <?><?><?><?><?> 0<?> <?><?><?><?> null |
           length --> 0


         o <?><?><?><?>: <?><?><?><?> <?><?><?><?> true | try length catch
           "fail" --> "fail"


         o <?><?><?>: <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> -1, 1 |
           length --> 1 1


         o <?><?><?><?> <?><?><?><?>: <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> "<?><?><?><?><?>" |
           length --> 5


         o <?><?><?><?> <?><?><?><?><?>: <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> "<?><?><?><?><?>" | tobytes |
           length --> 15


         o <?><?><?><?><?>: <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           [1, [2, 3], 4] | length --> 3


         o <?><?><?>: <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?>-<?><?><?><?><?><?> <?><?><?><?> {a: 0, b: 1} | length
           --> 2





   keys, keys_unsorted
       <?><?><?><?><?> keys_unsorted <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>.  <?><?><?><?><?>
       keys <?><?><?><?><?> <?><?> keys_unsorted | sort <?><?><?>.
       <?><?><?><?> <?><?><?><?><?>:


         o {c: 1, b: 2, a: 1} | keys_unsorted --> ["c", "b", "a"]


         o {c: 1, b: 2, a: 1} | keys          --> ["a", "b", "c"]


         o [1, 2, 3] | keys_unsorted --> [0, 1, 2]


         o [1, 2, 3] | keys          --> [0, 1, 2]






   to_entries, from_entries, with_entries(f)
       <?><?><?><?><?> to_entries <?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?> {key:
       k, value: v} <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> .[k] <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> v <?><?> <?><?><?><?><?><?>.  For example:


         o [   1,    2] | to_entries --> [{"key":  0 , "value": 1}, {"key":  1
           , "value": 2}]


         o {a: 1, b: 2} | to_entries --> [{"key": "a", "value": 1}, {"key":
           "b", "value": 2}]



       The filter from_entries constructs an object from an array of entries
       as given by to_entries.  For example, {a: 1, b: 2} | to_entries |
       from_entries --> {"a": 1, "b": 2}.

       The filter with_entries(f) is equivalent to to_entries | map(f) |
       from_entries.  For example, {"a": 1, "b": 2} | with_entries(.key |=
       ascii_upcase) --> {"A": 1, "B": 2}




   <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (STREAM CONSUMERS)
   first, first(f), last, last(f)
       The filter first(f) yields the first output of f if there is one, else
       nothing.  For example, first(1, 2, 3) --> 1 and first(empty) --> (no
       output).

       This filter stops evaluating f after the first output, meaning that it
       yields an output even if f yields infinitely many outputs.  For
       example, first(repeat(0)) --> 0 and first(1, def f: f; f) --> 1.

       Similarly, last(f) yields the last output of f if there is one, else
       nothing.  If f yields an error, then the first error of f is yielded.
       For example, last(1, 2, 3) --> 3, last(empty) --> (no output), and try
       last(1, error("fail"), 3) catch . --> "fail".

       The filters first and last are short forms for first(.[]) and
       last(.[]), respectively.  You can use them to retrieve the first/last
       element of an array, such as [1, 2, 3] | first, last --> 1 3.



   limit($n; f)
       The filter limit($n; f) yields the first $n outputs of f.  If $n <= 0,
       it yields no outputs.  For example:


         o limit( 3; 1, 2      ) --> 1 2


         o limit( 3; 1, 2, 3, 4) --> 1 2 3


         o limit(-1; 1, 2      ) --> (no output)



       <?><?><?><?><?><?><?>
              When $n < 0, jq yields an error instead.




   skip($n; f)
       The filter skip($n; f) yields all outputs after the first $n outputs of
       f.  If $n <= 0, it yields all outputs of f.  For example:


         o skip( 3; 1, 2      ) --> (no output)


         o skip( 1; 1, 2, 3, 4) --> 2 3 4


         o skip(-1; 1, 2      ) --> 1 2





   nth($i), nth($i; f)
       The filter nth($i; f) yields the $i-th output of f.  If f yields less
       than $i outputs, then this filter yields no output.  For example:


         o nth(0; 1, 2, 3) --> 1


         o nth(2; 1, 2, 3) --> 3


         o nth(3; 1, 2, 3) --> (no output)



       The filter nth($i) is a short form for .[$i]; e.g.  [1, 2, 3] | nth(0)
       --> 1.



   isempty(f)
       <?><?><?><?><?> isempty(f) <?><?> <?><?><?><?><?> <?><?> f <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> true <?> <?><?>
       <?><?><?> <?><?><?> <?><?><?><?> false
       <?><?><?><?><?><?><?><?><?><?><?>.  If the first output of f is an
       error, isempty(f) yields that error instead.  For example:


         o isempty(   empty) --> true


         o isempty(1,     2) --> false


         o isempty(1, error) --> false


         o try isempty(error, 1) catch "fail" --> "fail"





   any, any(p), any(f; p)
       The filter any(f; p) yields true if any output of f | p has the boolean
       value true, else false.  For example:


         o any(0, 1, 2; . == 42) --> false


         o any(0, 1, 2; . == 42, . == 2) --> true



       The filters any(p) and any are short forms of any(.[]; p) and any(.),
       respectively.  For example:


         o [1, 2, 3] | any(. % 2 == 0) --> true


         o [false, true] | any --> true





   all, all(p), all(f; p)
       The filter all(f; p) yields true if all outputs of f | p have the
       boolean value true, else false.  For example:


         o all(0, 1, 2; . >  0) --> false


         o all(0, 1, 2; . >= 0) --> true



       The filters all(p) and all are defined analogously to any(p) and any.



   add, add(f)
       The filter add(f) yields the sum of all elements yielded by f, or null
       if f yields no outputs.  For example:


         o add(1, 2, 3) --> 6


         o add(empty) --> null



       The filter add is a short form of add(.[]).  You can use it to add all
       values of an array or object:


         o [1, 2, 3]    | add --> 6


         o {a: 1, b: 2} | add --> 3







   <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (STREAM GENERATORS)
   empty
       The filter empty yields no output.




   range($upto), range($from; $upto), range($from; $upto; $step)
       The filter range($from; $upto; $step) adds $step to $from until it
       exceeds $upto.  For example:


         o range(1;  9;  2) --> 1 3 5 7


         o range(1; 10;  2) --> 1 3 5 7 9


         o range(9;  1; -2) --> 9 7 5 3


         o range(9;  0; -2) --> 9 7 5 3 1



       The filter range($from; $upto) is a short form of range($from; $upto;
       1) and the filter range($upto) is a short form of range(0; $upto).  For
       example:


         o range(5) --> 0 1 2 3 4


         o range(2; 5) --> 2 3 4



       <?><?><?><?><?><?><?>
              In jq, range/1 and range/2 are more restrictive versions of
              range/3 that prohibit non-numeric arguments.





   recurse, recurse(f)
       The filter recurse(f) is equivalent to ., (f | recurse(f)).  It first
       outputs its input, then runs f and recurse(f) on its outputs.  This is
       useful to create infinite sequences.  You can create a finite sequence
       by having f return empty, e.g. via select.  For example:


         o 0 | limit(5; recurse(.+1))       --> 0 1 2 3 4


         o 0 | recurse(.+1 | select(. < 5)) --> 0 1 2 3 4



       The filter recurse(f; p) is equivalent to recurse(f | select(p)).  That
       means that it recurses only on outputs of f for which p yields a true
       output.  For example:


         o 0 | recurse(.+1; . < 5) --> 0 1 2 3 4



       The filter recurse is a short form for recurse(.[]?).  It returns all
       values recursively contained in the input, e.g.  [1, [2], {a: 3}] |
       recurse --> [1, [2], {"a": 3}] 1 [2] 2 {"a":3} 3.  It yields the same
       outputs as .. (recursion).




   repeat(f)
       The filter repeat(f) runs f and yields its outputs over and over again.
       For example, 2 | limit(7; repeat(1, ., 3)) --> 1 2 3 1 2 3 1.




   while(p; f), until(p; f)
       The filter while(p; f) yields its input and applies f to it, while p
       returns true.

       The filter until(p; f) applies f to its input until p returns true, at
       which point the filter returns its input.

       Examples:


         o 0 | while(. <= 3; . + 1) --> 0 1 2 3


         o 0 | until(. >= 3; . + 1) --> 3






   <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> (SELECTION)
       The filters in this section classify their inputs or output them
       selectively.


   select(p)
       The filter select(p) yields its input for each true output of p.  For
       example, (0, 1, -1, 2, -2) | select(. >= 0) --> 0 1 2.



   nulls, booleans, numbers, strings, arrays, objects
       Any of these filters yields its input if it is of the given type, else
       nothing.  For example:


         o null, true, 0, "Hi!", [1, 2], {a: 1} | nulls    --> null


         o null, true, 0, "Hi!", [1, 2], {a: 1} | booleans --> true


         o null, true, 0, "Hi!", [1, 2], {a: 1} | numbers  --> 0


         o null, true, 0, "Hi!", [1, 2], {a: 1} | strings  --> "Hi!"


         o null, true, 0, "Hi!", [1, 2], {a: 1} | arrays   --> [1, 2]


         o null, true, 0, "Hi!", [1, 2], {a: 1} | objects  --> {"a": 1}






   isboolean, isnumber, isstring, isarray, isobject
       For every filter in this section, like isboolean, <?>, isobject, there
       is a corresponding filter in the previous section like, booleans, <?>,
       objects.  Any of these filters yields true if its corresponding filter
       in the previous section yields some output, else false.  For example:


         o null | isboolean --> false, because null | booleans --> (no
           output).


         o true | isboolean --> true , because true | booleans --> true.



       <?><?><?><?><?><?><?>
              jq does not implement these filters.




   normals, finites
       These filters return its input if isnormal or isfinite is true,
       respectively, else false.



   values, iterables, scalars
       The filter values yields its input if it is not null, else nothing.

       If a value is either an array or an object, it is said to be iterable;
       otherwise, it is said to be scalar.  (The iteration filter .[] succeeds
       on any iterable value, whereas it fails on any scalar.)

       The filters iterables and scalars yield their input if it is iterable
       or scalar, respectively, else nothing.

       Examples:


         o null, true, 0, "Hi!", [1, 2], {a: 1} | values    --> true 0 "Hi!"
           [1, 2] {"a": 1}


         o null, true, 0, "Hi!", [1, 2], {a: 1} | scalars   --> null true 0
           "Hi!"


         o null, true, 0, "Hi!", [1, 2], {a: 1} | iterables --> [1, 2] {"a":
           1}





   isnan, isinfinite, isfinite, isnormal
       The filter isnan yields true if its input is NaN, else false.  Note
       that it is not equivalent to . == nan, because nan is not equal to
       itself; see equality.

       The filter isinfinite yields true if its input is either Infinity or
       -Infinity, else false.

       The filter isfinite yields true if its input is a number that is not
       infinite, else false.

       The filter isnormal yields true if its input is a number that is
       neither 0, NaN, nor infinite.

       Examples:


         o nan      | isnan, isinfinite, isfinite, isnormal --> true  false
           true  false


         o infinite | isnan, isinfinite, isfinite, isnormal --> false true
           false false


         o 0        | isnan, isinfinite, isfinite, isnormal --> false false
           true  false


         o 1        | isnan, isinfinite, isfinite, isnormal --> false false
           true  true





   type
       The filter type returns the type of its input value as string. For
       example:


         o null  | type --> "null"


         o false | type --> "boolean"


         o 0     | type --> "number"


         o "foo" | type --> "string"


         o [1]   | type --> "array"


         o {}    | type --> "object"



       Note that both text strings and byte strings both have the same type
       "string".





   <?><?><?><?><?> <?> <?><?><?><?><?> (MEMBERSHIP)
   contains($x), inside($x)
       The filter contains($x) yields true if any of the following conditions
       holds, else false.


         o The input is a string and $x is a substring of it.


         o The input is an array, $x is an array, and for every value v in $x,
           there is some value in the input that contains(v).


         o The input is an object, $x is an object, and for every key-value
           pair {k: v} in $x, there is a value for the key k in the input that
           contains(v).


         o The input is null, boolean, or a number, and $x is equal to the
           input.



       Examples:


         o "Hello, world!" | contains("world")  --> true


         o [1, 2, 3]       | contains([1, 3])   --> true


         o [[1, 2], 3]     | contains([3, [1]]) --> true


         o {a: 1, b: 2}    | contains({a: 1})   --> true


         o {a: [1, 2]}     | contains({a: [1]}) --> true


         o 0               | contains(0)        --> true



       The filter inside($x) is a flipped version of contains.  For example,
       "world" | inside("Hello, world") --> true.




   indices($x)
       The filter indices($x) yields the following:


         o If the input and $x are either both strings or both arrays, then it
           yields the indices i for which .[i:][:$x | length] == $x; e.g.
           "Alice, Bob, and Carol" | indices(", ") --> [5, 10] and [0, 1, 2,
           3, 1, 2, 3] | indices([1, 2]) --> [1, 4].


         o If the input is an array and $x is not an array, then it yields the
           indices i for which .[i] == $x; e.g.  [0, 1, 2, 3, 1, 2, 3] |
           indices(1) --> [1, 4].


         o Otherwise, it yields an error.



       This means that [[1, 2], 3] | indices([1, 2]) --> [], because the input
       array has neither 1 nor 2, just [1, 2] and 3.




   index($x), rindex($x)
       The filters index($x) and rindex($x) are shorthand for indices($x) |
       first and indices($x) | last, respectively.  For example:


         o "Alice, Bob, and Carol" | index(", ") --> 5


         o [0, 1, 2, 3, 1, 2, 3] | rindex([1, 2]) --> 4


         o "Hello world!" | index(", ") --> null


         o [0, 1, 2] | rindex(3) --> null





   has($k), in($x)
       The filter has($k) yields true if .[$k] points to data in the input,
       else false.  For example:


         o [1, 2, 3]    | has( 0 ,  3 ) --> true false


         o {a: 1, b: 2} | has("a", "c") --> true false



       The filter in($x) is a flipped version of has, just like inside is a
       flipped version of contains.  For example, "a" | in({a: 1, b: 2}) -->
       true.

       <?><?><?><?><?><?><?>
              Whenever has($k) in jq returns true, jaq also returns true.
              However, when has($k) yields true in jaq, it may also yield
              false or an error in jq:


                o [1, 2, 3] | has(-1, -2, -3) --> true true true (false false
                  false in jq)


                o [1, 2, 3] | has({start: 1}) --> true (error in jq)



              This difference arises because in jq, has($k) has a much weaker
              relationship with .[$k] than in jaq.  The following properties
              hold in both jq and jaq:


                o [1, 2, 3] | .[-1, -2, -3] --> 3 2 1


                o [1, 2, 3] | .[{start: 1}] --> [2, 3]








   <?><?><?><?><?><?><?><?><?><?><?><?><?><?> (UPDATES)
   map(f), map_values(f)
       The filter map(f) obtains all values of the input (via .[]), applies f
       to the values, and collects all results into an array.  For example:


         o [1, 2, 3]    | map(., .*2) --> [1, 2, 2, 4, 3, 6].


         o {a: 1, b: 2} | map(., .*2) --> [1, 2, 2, 4].


         o [1, 2, 3, 4] | map(select(. % 2 == 0)) --> [2, 4].



       The filter map_values(f) has the same effect as map(f) when the input
       is an array, but when the input is an object, map_values(f) also
       outputs an object.  For example:


         o [1, 2, 3, 4] | map_values(.*2) --> [2, 4, 6, 8]


         o {a: 1, b: 2} | map_values(.*2) --> {"a": 2, "b": 4}






   walk(f)
       The filter walk(f) recursively updates its input with f.  For example:


         o [[1, 2], [3]] | walk(numbers += 1) --> [[2, 3], [4]]






   del(f)
       The filter del(f) deletes values at the locations given by f.  It is
       equivalent to f |= empty.  For example:


         o [1, 2, 3, 4] | del(.[] | select(. % 2 == 0)) --> [1, 3]


         o [1, 2, 3]    | del(.[1]) --> [1, 3]


         o [1, 2, 3]    | del(.[1:]) --> [1]


         o {a: 1, b: 2} | del(.a) --> {"b": 2}






   <?><?><?><?><?><?> (PATHS)
   path(f)
       The filter path(f) records for each output of f its position in the
       input, and yields that position as a path.  A path is an array that may
       contain indices or "slice objects".  The latter must contain a "start"
       and/or an "end" key with an integer value.  For example:


         o [{a: 1}, {a: 2}] | path(.[].a) --> [0, "a"] [1, "a"]


         o [1, 2, 3] | path(.[1:][:-1]) --> [{"start": 1}, {"end": -1}]


         o [1, 2, 3] | path(.[1:   -1]) --> [{"start": 1,   "end": -1}]



       If f returns values that do not point to the input, then path(f) yields
       an error.


         o try path(0           ) catch "fail" --> "fail"


         o try path(. as $x | $x) catch "fail" --> "fail"






   paths, paths(p)
       The filter paths yields the paths to all ancestor values of the input.
       It is equivalent to skip(1; path(..)).

       The filter paths(p) yields the paths to all ancestor values of the
       input for which p yields true.

       Examples:


         o [1, {a: 2}] | paths           --> [0] [1] [1, "a"]


         o [1, {a: 2}] | paths(isnumber) --> [0]     [1, "a"]


         o [1, {a: 2}] | paths(isobject) -->     [1]






   getpath($path)
       The filter getpath($path) is the inverse filter for path(f).  If
       path(f) yields no error, then getpath(path(f)) yields the same outputs
       as f.  For example:


         o [{a: 1}, {a: 2}] | getpath([0, "a"], [1, "a"]) --> 1 2


         o [1, 2, 3] | getpath([{"start": 1}, {"end": -1}]) --> [2]


         o [1, 2, 3] | getpath([{"start": 1,   "end": -1}]) --> [2]





   setpath($path; $v)
       <?><?><?><?><?> setpath($path; $v) <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> $path <?><?> <?><?><?> $v <?><?><?><?><?>
       <?><?><?><?><?><?>.  It is equivalent to getpath($path) = $v.  For
       example:


         o [[1, 2], [3, 4]] | setpath([1, 0]; 5) --> [[1, 2], [5, 4]]





   delpaths($paths)
       The filter delpaths($paths) takes an array of paths and deletes all
       corresponding values in the order given by the array.  For example:


         o [1, 2, 3] | delpaths([[0]])      --> [2, 3]


         o [{a: 1, b: 2}, 3] | delpaths([[0, "b"], [1]]) --> [{"a": 1}]



       <?><?><?><?><?><?><?>
              In jq, the $paths are interpreted relative to the original input
              value, whereas in jaq, they are interpreted relative to the
              current value.  For example, [1, 2, 3] | delpaths([[0], [0]])
              --> [3] in jaq, because it first deletes the 0-th element 1
              (yielding [2, 3]), then it  deletes the 0-th element 2 (yielding
              [3]).  Here, jq yields [2, 3], because the 0-th element always
              refers to the 0-th element of the original input, which is 1.

              To use delpaths in an interoperable fashion, use $paths such
              that:


                o Paths to descendants come before paths to their ancestors.


                o Paths to array elements to the right come before paths to
                  elements to the left.



              For example, .. returns ancestors before descendants and array
              elements to the left before elements to the right.  To use the
              output of .. in delpaths, it suffices to reverse the order of
              its outputs:


                o ["a", 0, "b", 1] | delpaths([path(.. | strings)] | reverse)
                  --> [0,  1 ] (right)


                o ["a", 0, "b", 1] | delpaths([path(.. | strings)]          )
                  --> [0, "b"] (wrong)






   pick(f)
       The filter pick(f) constructs an object that contains only those parts
       of the input that f returns.  For example:


         o {a: {b: 1, c: 2}, d: 3} | pick(.       ) --> {"a": {"b": 1, "c":
           2}, "d": 3}


         o {a: {b: 1, c: 2}, d: 3} | pick(.a.c    ) --> {"a": {        "c": 2}
           }


         o {a: {b: 1, c: 2}, d: 3} | pick(.a.c, .d) --> {"a": {        "c":
           2}, "d": 3}



       <?><?><?><?><?><?><?>
              In jq, pick(f) also supports paths to arrays; for example:


                o [1, 2, 3] | pick(.[0 ]) yields [1]


                o [1, 2, 3] | pick(.[1 ]) yields [null, 2]


                o [1, 2, 3] | pick(.[1:]) yields [2, 3]



              While implementing this functionality in jaq, I found many
              corner cases that would have made the proper documentation of
              this filter very complex.  I also found a few surprising
              behaviours in jq, e.g. that [1, 2, 3] | pick(.[-1]) yields an
              error.  In the end, I decided to support only the simpler and
              well-understandable subset of paths to objects.






   <?><?><?><?><?><?><?> (BOOLEANS)
   true, false
       The filters true and false yield the values true and false,
       respectively:


         o true  --> true


         o false --> false





   not
       The filter not converts its input to its boolean value and returns its
       negation.  For example:


         o true  | not --> false


         o false | not --> true


         o "foo" | not --> false






   toboolean
       The filter toboolean is for booleans what tonumber is for numbers.  For
       example:


         o   true   | toboolean --> true


         o  "true"  | toboolean --> true


         o "[true]" | try toboolean catch "fail" --> "fail"






   <?><?><?><?><?> (NUMBERS)
   tonumber
       The filter tonumber takes as input either a number or a string.  If the
       input is a number, it is returned unchanged; if the input is a string,
       it is parsed to a number, failing if this does not succeed.  For
       example:


         o   42   | tonumber --> 42


         o  "42"  | tonumber --> 42


         o "[42]" | try tonumber catch "fail" --> "fail"





   infinite, nan
       The filters infinite and nan yield the floating-point numbers Infinity
       and NaN:


         o infinite --> Infinity


         o nan | isnan --> true (we cannot test for equality with NaN here,
           because nan == nan --> false)






   abs
       The filter abs yields the negation of the input if the input is smaller
       than 0, else it yields the input.  Note that due to this definition,
       strings, arrays, and objects are also returned unchanged, because they
       are larger than 0; see ordering.

       Examples:


         o -2.0, -1, 0, 1, 2.0 | abs --> 2.0 1 0 1 2.0


         o "foo", [], {}       | abs --> "foo" [] {}





   floor, round, ceil
       The filters floor, round and ceil round a number to its closest smaller
       integer, to its closest integer, and to its closest larger integer,
       respectively.  For example:


         o  0.5 | floor, round, ceil -->  0  1 1


         o  0.4 | floor, round, ceil -->  0  0 1


         o  0.0 | floor, round, ceil -->  0  0 0


         o -0.4 | floor, round, ceil --> -1  0 0


         o -0.5 | floor, round, ceil --> -1 -1 0


         o 0, 1 | round --> 0 1


         o nan | round | isnan --> true


         o infinite | round --> Infinity





   <?><?><?><?><?><?><?> (Math)
       jaq implements many mathematical functions via libm
       <https://docs.rs/libm>.  If not specified otherwise, these filters take
       and return floating-point numbers.

       Zero-argument filters:


         o acos


         o acosh


         o asin


         o asinh


         o atan


         o atanh


         o cbrt


         o cos


         o cosh


         o erf


         o erfc


         o exp


         o exp10


         o exp2


         o expm1


         o fabs


         o frexp, which returns pairs of (float, integer).


         o gamma


         o ilogb, which returns integers.


         o j0


         o j1


         o lgamma


         o log


         o log10


         o log1p


         o log2


         o logb


         o modf, which returns pairs of (float, float).


         o nearbyint


         o pow10


         o rint


         o significand


         o sin


         o sinh


         o sqrt


         o tan


         o tanh


         o tgamma


         o trunc


         o y0


         o y1



       Two-argument filters that ignore .:


         o atan2


         o copysign


         o drem


         o fdim


         o fmax


         o fmin


         o fmod


         o hypot


         o jn, which takes an integer as first argument.


         o ldexp, which takes an integer as second argument.


         o nextafter


         o nexttoward


         o pow


         o remainder


         o scalb


         o scalbln, which takes as integer as second argument.


         o yn, which takes an integer as first argument.



       Three-argument filters that ignore .:


         o fma



       Examples:


         o (3.141592 | sin) < (-5 | pow10) --> true establishes that sin(pi)
           is smaller than 10^-5.


         o fmax(2; 3) --> 3.0


         o fma(2; 3; 4) --> 10.0






   <?><?><?><?><?><?><?><?> (ARRAYS)
   sort, sort_by(f)
       <?><?><?><?><?> sort <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:

              [true, 1, "abc", [1], {"a": 1}, null, false, 0, "ABC", [], {}] | sort -->
              [null, false, true, 0, 1, "ABC", "abc", [], [1], {}, {"a": 1}]


       <?><?><?><?><?> sort_by(f) <?><?><?><?><?> f <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> f <?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:


         o [0, 1, 2, 3] | sort_by(. % 2) --> [0, 2, 1, 3]


         o [{a: 1, b: 2}, {a: 0, b: 3}] | sort_by(. ) --> [{"a": 0, "b": 3},
           {"a": 1, "b": 2}]


         o [{a: 1, b: 2}, {a: 0, b: 3}] | sort_by(.a) --> [{"a": 0, "b": 3},
           {"a": 1, "b": 2}]


         o [{a: 1, b: 2}, {a: 0, b: 3}] | sort_by(.b) --> [{"a": 1, "b": 2},
           {"a": 0, "b": 3}]






   group_by(f)
       <?><?><?><?><?> group_by(f) <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> f <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> f <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>:


         o ["foo", "", "bar", "quux", "baz"] | group_by(length) --> [[""],
           ["foo", "bar", "baz"], ["quux"]]


         o [1, 2, 3, 4] | group_by(. % 2) --> [[2, 4], [1, 3]]





   unique, unique_by(f)
       <?><?><?><?><?> unique_by(f) <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> f <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> f
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:


         o ["foo", "", "bar", "quux", "baz"] | unique_by(length) --> ["",
           "foo", "quux"]


         o [1, 2, 3, 4] | unique_by(. % 2) --> [2, 1]



       <?><?><?><?><?> unique <?><?><?><?><?> <?><?> unique_by(.) <?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?>: [3, 2, 1, 3, 4] | unique --> [1, 2, 3, 4].



   min, max, min_by(f), max_by(f)
       <?><?><?><?><?><?><?><?> min <?> max <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:


         o [1, 2, 3] | min --> 1


         o [1, 2, 3] | max --> 3



       The filters min_by(f) and max_by(f) evaluate the filter f for each
       value in the input array, and yield the value for which f produces the
       smallest or largest output, respectively.  For example:


         o ["abc", [1, 2], {"a": 1}] | min_by(length) --> {"a": 1}


         o ["abc", [1, 2], {"a": 1}] | max_by(length) --> "abc"



       You can yield multiple values in f to break ties such as:


         o ["abc", [1, 2], {"a": 1, "b": 3}] | min_by(length, add?) --> [1, 2]






   reverse
       The filter reverse takes an array and reverses it.  For example, [1, 2,
       3] | reverse --> [3, 2, 1].



   transpose
       The filter transpose takes an array of arrays and yields its
       transposition.

       Examples:


         o [[1 ,  2, 3], [4, 5, 6]] | transpose --> [[1, 4], [2, 5], [3, 6]]


         o [[1], [2, 3], [4, 5, 6]] | transpose --> [[1, 2, 4], [null, 3, 5],
           [null, null, 6]]






   flatten, flatten($depth)
       The filter flatten flattens input arrays, and the filter
       flatten($depth) flattens input arrays up to a certain depth.  For
       example:


         o [1, [2, [3]], {a: [1, [2]]}] | flatten    --> [1,  2,  3  , {"a":
           [1, [2]]}]


         o [1, [2, [3]], {a: [1, [2]]}] | flatten(0) --> [1, [2, [3]], {"a":
           [1, [2]]}]


         o [1, [2, [3]], {a: [1, [2]]}] | flatten(1) --> [1,  2, [3] , {"a":
           [1, [2]]}]


         o [1, [2, [3]], {a: [1, [2]]}] | flatten(2) --> [1,  2,  3  , {"a":
           [1, [2]]}]


         o null, true, 0, "Hi" | flatten --> [null] [true] [0] ["Hi"]



       Note that flatten does not impact arrays that are descendants of an
       object.




   bsearch($x)
       The filter bsearch($x) takes a sorted array and performs a binary
       search for $x in the array.  If the array contains $x, then the filter
       yields a positive $i such that .[$i] == $x; otherwise, the filter
       yields a negative $i such that inserting $x at the index -$i-1 in the
       array would preserve its the ordering.

       Examples:


         o [0, 4, 8] | bsearch(8, 4, 0) --> 2 1 0


         o [0, 4, 8] | bsearch(-2, 2, 6, 10) --> -1 -2 -3 -4



       If the input array is not sorted, then the output of this filter is
       meaningless.




   combinations, combinations($n)
       The filter combinations takes as input an array of arrays, such as [a1,
       ..., an].  It yields all combinations of the elements of the arrays a1
       to an:

              [[1, 2], [3, 4]] | combinations -->
              [1, 3]
              [1, 4]
              [2, 3]
              [2, 4]


       When the input array is empty, combinations yields an empty array; [] |
       combinations --> [].

       The filter combinations($n) takes a single array a1 as input.  Its
       output is equivalent to [a1, ..., a1] | combinations, where a1 is
       repeated $n times.

              [1, 2] | combinations(2) -->
              [1, 1]
              [1, 2]
              [2, 1]
              [2, 2]






   <?><?><?><?><?><?><?><?> <?><?><?><?> (TEXT STRINGS)
       Unless stated otherwise, all filters in this section take a text string
       as input, and fail if the input is of any other type.


   tostring
       <?><?><?><?><?> tostring <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.  Its output depends on
       the type of its input:


         o Text strings are returned unchanged, i.e. "Hi" | tostring --> "Hi".


         o Byte strings are interpreted as text string, i.e. "Hi" | tobytes |
           tostring --> "Hi".  This takes constant time.


         o Any other value is formatted compactly as if output by jaq -c. For
           example:


           o null | tostring --> "null",


           o [0, 1] | tostring --> "[0,1]",


           o {a: 1} | tostring --> "{\"a\":1}".








   utf8bytelength
       The filter utf8bytelength yields the number of bytes of the input
       string.  It is equivalent to tobytes | length, but different from
       length, which counts the number of characters.

       For example, "<?><?><?><?><?>" | length, utf8bytelength, (tobytes |
       length) --> 5 15 15.



   startswith($s), endswith($s)
       The filter startswith($s) yields true if the input string starts with
       the string $s, else false.  Similar for endswith($s).  For example:


         o "<?><?><?><?><?>" | startswith("<?><?>") --> true


         o "<?><?><?><?><?>" | endswith("<?><?><?>") --> true





   trim, ltrim, rtrim
       The filters ltrim and rtrim remove from the input string all leading
       and trailing whitespace, respectively.  Here, whitespace corresponds to
       the White_Space Unicode property.  The filter trim is equivalent to
       ltrim | rtrim.

       For example:


         o " \t\n<?>Bonjour ! <?> \r<?><?>" | ltrim --> "Bonjour ! <?>
           \r<?><?>"


         o " \t\n<?>Bonjour ! <?> \r<?><?>" | rtrim --> " \t\n<?>Bonjour !"



       Note that there are a few quite unusual whitespace characters in this
       string.



   ltrimstr($s), rtrimstr($s)
       The filters ltrimstr($s) and rtrimstr($s) remove a single occurrence of
       $s from the start or the end of the string, respectively.  If there is
       no such occurrence, the original string is returned.  For example:


         o "foofoobar" | ltrimstr("foo") --> "foobar"


         o "foobarbar" | rtrimstr("bar") --> "foobar"





   explode, implode
       The filter explode yields an array containing a positive number for
       each valid Unicode code point of the input string and a negative number
       for each byte of each invalid Unicode code unit.  For example:

              "Dear <?><?>" + (255 | tobytes | tostring) | explode -->
              [68,101,97,114,32,9728,65039,-255]


       Here, we can see that "<?><?>" has turned into two code points, namely
       9728 and 65039, whereas the invalid FF byte (= 255) has become -255.

       The inverse filter of explode is implode:

              [68,101,97,114,32,9728,65039, -255] | implode[:-1] -->
              "Dear <?><?>"


       (I omitted the FF byte at the end, because it is hard to save in a text
       editor.)

       <?><?><?><?><?><?><?>
              jq does not permit invalid code units in text strings, so it
              returns and accepts only natural numbers in explode and implode.




   split($s)
       This filter yields . / $s if its input . and $s are both strings, else
       it fails.  See the section on division for details.

       Note that there is also split($re; $flags) that splits by a regex.



   join($s)
       The filter join($s) takes as input an array [x1, ..., xn] and yields ""
       if the array is empty, otherwise "\(x1)" + $s + ... + $s + "\(xn)".
       That is, it concatenates the string representations of the array values
       interspersed with $s.

       For example, to memorise the hierarchy of values in jq: ["null",
       "boolean", "number", "string", "array", "object"] | join(" < ") -->
       "null < boolean < number < string < array < object".

       <?><?><?><?><?><?><?>
              Unlike jq, jaq does not map null values in the array to "", nor
              does it reject array or object values in the array.




   ascii_downcase, ascii_upcase
       The filters ascii_downcase and ascii_upcase convert all ASCII letters
       in the input string to their lower/upper case variants, respectively.
       For example:


         o "Der <lambda><Pi>-Kalkul" | ascii_downcase --> "der
           <lambda><Pi>-kalkul"


         o "Der <lambda><Pi>-Kalkul" | ascii_upcase   --> "DER
           <lambda><Pi>-KALKuL"






   <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> (TEXT
       STRING FORMATTING)
       The filters in this section can be prefixed to strings to influence
       string interpolation.  However, these filters can also be used outside
       of string interpolation.  For example:


         o "1 + 2 * 3" | @uri "https://duckduckgo.com/?q=\(.)" -->
           "https://duckduckgo.com/?q=1%20%2B%202%20%2A%203"


         o "1 + 2 * 3" | @uri --> "1%20%2B%202%20%2A%203"



       If not indicated otherwise, all filters in this section convert their
       input to a string with tostring and yield a single string output.  As
       result, byte strings are treated like equivalent text strings; e.g.
       "Hello world!" | (tobytes | @base64) == @base64 --> true.

       <?><?><?><?><?><?><?>
              Unlike in jq, you can define you own filters that start with @;
              for example, def @xml: @html;



   @text
       The filter @text is equivalent to tostring.



   @json
       The filter @json is equivalent to tojson.



   @csv, @tsv
       The filters @csv and @tsv are equivalent to tocsv and totsv,
       respectively.



   @html, @htmld
       The filter @html escapes a string so that it can be embedded in an HTML
       document.  It replaces the following characters by HTML equivalents:


         o "<"  | @html --> "&lt;"


         o ">"  | @html --> "&gt;"


         o "&"  | @html --> "&amp;"


         o "'"  | @html --> "&apos;"


         o "\"" | @html --> "&quot;"



       The filter @htmld reverses the effect of @html.  For example:

              "\"1 < 2 & 2 > 1\", that's what he said." | @html | ., @htmld -->
              "&quot;1 &lt; 2 &amp; 2 &gt; 1&quot;, that&apos;s what he said."
              "\"1 < 2 & 2 > 1\", that's what he said."


       <?><?><?><?><?><?><?>
              jq does not support @htmld.




   @base64, @base64d
       The filter @base64 Base64
       <https://en.wikipedia.org/wiki/Base64>-encodes its input.  The filter
       @base64d reverses this operation.  For example:

              "Hello world!" | @base64 | ., @base64d -->
              "SGVsbG8gd29ybGQh"
              "Hello world!"


       <?><?><?><?><?><?><?>
              In jaq, @base64d only succeeds if its whole input is a valid
              Base64 string.  In contrast, jq accepts also strings where only
              a part is valid Base64, thus potentially leading to hidden data
              corruption.  See #282 <https://github.com/01mf02/jaq/issues/282>
              for a detailed discussion.




   @uri, @urid
       The filter @uri applies percent-encoding
       <https://en.wikipedia.org/wiki/Percent-encoding>

       to encode arbitrary data in a uniform resource identifier (URI).  The
       filter @urid reverses this encoding.  For example:


         o "Hello, World!" | @uri --> "Hello%2C%20World%21"


         o "Hello, World!" | @uri | @urid --> "Hello, World!"






   @sh
       The filter @sh escapes data for constructing Unix command-line prompts.
       It performs different things depending on its input type:


         o null, boolean, number: Convert to string via tostring.


         o String: Replace occurrences of ' by '\'' and surround by '.


         o Array of scalars: Apply @sh to elements and join the results with "
           " as separator.


         o Fail for any other type of value.



       Examples:


         o null, true, 1 | @sh --> "null" "true" "1"


         o "It's green!" | @sh --> "'It'\\''s green!'"


         o ["jaq", "-n", "--arg", "slogan", "It's green!", "$slogan"] | @sh
           --> "'jaq' '-n' '--arg' 'slogan' 'It'\\''s green!' '$slogan'"







   <?><?><?><?><?><?><?><?> <?><?><?><?><?> (BYTE STRINGS)
   tobytes
       The filter tobytes converts its input to a byte string.  Its output
       depends on the type of input:


         o Natural number in the range 0 to 255 (0xFF): Yields a byte string
           with a single byte, e.g.  0 | tobytes --> b"\x00".


         o Text string: Yields a byte string containing the underlying bytes
           of the text string, e.g.  "Hi" | tobytes --> b"Hi".  This takes
           constant time.


         o Byte string: Yields the byte string unchanged.


         o Array: Converts each element to a byte string and yields their
           concatenation, e.g.  [0, "Hi", [1, 255]] | tobytes -->
           b"\x00Hi\x01\xFF".  This is equivalent to map(tobytes) | add.


         o Anything else: Yields an error.



       This is inspired by Erlang's iolist_to_binary function.

       <?><?><?><?><?><?><?>
              jq does not have byte strings and thus does not have tobytes.
              fq, which has pioneered the tobytes filter, has both.





   <?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?><?>
       (SERIALISATION & DESERIALISATION)
       The filters in this section read and write data in all formats
       supported by jaq.  See the formats section for general information
       about how jaq interprets these formats.

       <?><?><?><?><?><?><?>
              jq supports only JSON, so it only implements the fromjson/tojson
              filters in this section.



   fromjson, tojson
       The filter fromjson takes a string as input, parses it to JSON values
       and yields them.  For example:

              "null true 0 \"foo\" [1] {\"foo\": 1}" | fromjson -->
               null true 0  "foo"  [1] { "foo" : 1}


       The filter tojson takes an arbitrary value and outputs a string
       containing its JSON representation.  For example:

               [null,true,0, "foo" ,[1],{ "foo" :1}] | tojson -->
              "[null,true,0,\"foo\",[1],{\"foo\":1}]"


       Note that tojson behaves similarly to tostring, but when its input is a
       string, it will also encode it to JSON, instead of returning it
       unchanged; i.e.  "Hi" | tojson --> "\"Hi\"".

       <?><?><?><?><?><?><?>
              In jq, fromjson yields an error when its input string contains
              multiple JSON values.  Furthermore, in jaq, tojson | fromjson is
              equivalent to identity (.), whereas in jq, this is not the case,
              because nan | tojson | fromjson yields null, not nan.




   fromyaml, toyaml
       The filter fromyaml takes a text string and parses it as sequence of
       YAML documents.  It can yield an arbitrary number of outputs. For
       example:


         o "---\n 1 \n...\n---\n 2 \n..." | fromyaml --> 1 2


         o "" | fromyaml --> (no output)



       The filter toyaml always yields exactly one output, namely a text
       string containing the current value encoded as YAML.



   fromcbor, tocbor
       The filter fromcbor takes a byte string and parses it as sequence of
       CBOR values.  For example:

              [0, 1, 32, 64, 96, 128, 160,  244, 245, 246] | tobytes | fromcbor -->
               0  1  -1 b""  ""   []   {} false true null


       The filter tocbor always yields exactly one output, namely a byte
       string containing the current value encoded as CBOR.



   fromtoml, totoml
       The filter fromtoml takes a text string and parses it as a single TOML
       document.  It yields always one output, because every TOML document
       encodes exactly one value.  For example:

              "
              [database]\n
              enabled = true\n
              ports = [ 8000, 8001, 8002 ]\n
              data = [ [\"delta\", \"phi\"], [3.14] ]\n
              temp_targets = { cpu = 79.5, case = 72.0 }\n
              " | fromtoml -->
              {"database": {
                "enabled": true,
                "ports": [8000,8001,8002],
                "data": [["delta", "phi"], [3.14]],
                "temp_targets": {"cpu": 79.5, "case": 72.0}
              }}


       The filter totoml fails if the input is not an object or the input
       contains any jaq value not supported by TOML.  It converts invalid
       UTF-8 sequences like CBOR.



   fromxml, toxml
       The filter fromxml takes a text string and parses it as sequence of XML
       tags.  For example:

              "<?xml version='1.0'?>
              <html>
              <body xmlns='http://www.w3.org/1999/xhtml'>
              Hello HTML!
              </body>
              </html>" | fromxml -->
              {"xmldecl": {"version": "1.0"}}
              {"t": "html","c": [{
                "t": "body",
                "a": {"xmlns": "http://www.w3.org/1999/xhtml"},
                "c": ["Hello HTML!"]
              }]}


       The filter toxml takes data produced in the format by fromxml and
       yields a corresponding text string.

              [
              {"xmldecl": {"version": "1.0"}},
              {"t": "html","c": [{
                "t": "body",
                "a": {"xmlns": "http://www.w3.org/1999/xhtml"},
                "c": ["Hello HTML!"]
              }]}
              ] | toxml -->
              "<?xml version=\"1.0\"?>
              <html>
              <body xmlns=\"http://www.w3.org/1999/xhtml\">
              Hello HTML!
              </body>
              </html>"




   fromcsv, tocsv
       The filter fromcsv takes a string and yields each CSV row as an array
       of values.  For example, "1,2\n3,4\n" | fromcsv --> [1,2] [3,4].

       Strings can be written quoted or unquoted.  Inside quoted strings, ""
       denotes a single quote (").


         o "plain,with space"  | fromcsv --> ["plain","with space"]


         o "\"with,comma\""    | fromcsv --> ["with,comma"]


         o "\"with\nnewline\"" | fromcsv --> ["with\nnewline"]


         o "\"with\"\"quote\"" | fromcsv --> ["with\"quote"]



       The booleans true and false are returned as such.  An empty field is
       returned as null:


         o "true,,false" | fromcsv --> [true, null, false]



       Any field that is a valid XJON number is returned as such:

              "0,1,3.14,Infinity,+Infinity,-Infinity" | fromcsv -->
              [0,1,3.14,Infinity, Infinity,-Infinity]


       Quoted booleans, numbers, or empty strings are always returned as
       strings:

       "\"true\",\"\",\"false\",\"3.14\"" | fromcsv --> ["true", "", "false",
       "3.14"]

       Rows can be terminated with LF ("\n") or CRLF ("\r\n").  The last row
       may or may not be terminated with LF/CRLF.


         o "1,2\r\n3,4\n" | fromcsv --> [1,2] [3,4]


         o "1,2\n3,4\r\n" | fromcsv --> [1,2] [3,4]


         o "1,2\n3,4"     | fromcsv --> [1,2] [3,4]



       A few extreme cases:


         o ""   | fromcsv -->  (no output)


         o "\n" | fromcsv --> [null] (empty lines are interpreted as null)


         o ","  | fromcsv --> [null, null]



       The filter tocsv takes an array of scalars.  It transforms each array
       element depending on its type:


         o null: Yield "".


         o Boolean, number: Transform it via tostring.


         o String: Replace occurrences of " by "" and surround by ".


         o Fail for any other type of value.



       Finally, the filter joins the transformed elements with "," as
       separator.  For example:

              [true, null, false, 1, "Give me \"quotes\", or die"] | tocsv -->
              "true,,false,1,\"Give me \"\"quotes\"\", or die\""




   fromtsv, totsv
       The filter fromtsv takes a string and yields each TSV row as an array
       of values.  For example, "1\t2\n3\t4\n" | fromtsv --> [1,2] [3,4].

       The filter totsv is similar to tocsv, with the following differences:


         o In strings, the characters '\n', '\r', '\t', '\', and '\u0000' are
           replaced by strings "\\n", "\\r", "\\t", "\\\\", "\\0".  (In raw
           output, these look like \n, \r, \t, \\, and \0.) The result is not
           surrounded by ".


         o The transformed elements are joined with \t (tabulator).



       For example:

              [true, null, false, 1, "hello \"quotes\" and \n\r\t\\ escapes"] | totsv -->
              "true\t\tfalse\t1\thello \"quotes\" and \\n\\r\\t\\\\ escapes"


       TSV strings are always unquoted.  Encode control characters using \0,
       \t, \r, \n, and \\:


         o "with\\0NUL" | fromtsv --> ["with\u0000NUL"]


         o "with\\tTAB" | fromtsv --> ["with\tTAB"]


         o "with\\rCR"  | fromtsv --> ["with\rCR"]


         o "with\\nLF"  | fromtsv --> ["with\nLF"]


         o "with\\\\"   | fromtsv --> ["with\\"]







   <?><?><?><?><?> <?> <?><?><?><?> (DATE & TIME)
       The filters in this section serve to convert between different time
       formats, such as:


         o Unix epoch: Marks a point in time by the number of seconds passed
           since January 1, 1970 00:00:00 (UTC).  You can obtain the current
           time as Unix epoch via now.


         o ISO-8601 datetime string: Represents a date, a time, and a time
           zone as a string, such as "1970-01-01T00:00:00Z" (corresponding to
           Unix epoch 0).


         o "Broken down time" (BDT) array: Represents a date and a time as an
           array of the shape [year, month, day, hour, minute, second,
           weekday, yearday].  All components are integers, except for second,
           which may be a floating-point number.  The month is counted from 0,
           the weekday is counted from Sunday (which is 0), and the yearday is
           the day in the year counted from 0.  When a BDT array is used as
           input, only the first six components are considered.



       You can convert between these representations via:


         o Unix epoch from/to ISO 8601: fromdate, todate


         o BDT to Unix epoch: mktime


         o Unix epoch to BDT: gmtime, localtime


         o Unix epoch or BDT from/to custom string: strptime, strftime,
           strflocaltime



       As example, let us consider the time where the Hill Valley courthouse's
       clock tower was struck by lightning, namely Saturday, November 12,
       1955, at 10:04 p.m. PST
       <https://en.wikipedia.org/wiki/Hill_Valley_(Back_to_the_Future%29#Town_square>.
       The corresponding date can be written in ISO 8601 as
       "1955-11-12T10:04:00-08:00".  We can convert that to a Unix epoch and
       from there to a (UTC) BDT via:

              "1955-11-12T22:04:00-08:00" | fromdate | gmtime -->
              [
                1955,
                10,
                13,
                6,
                4,
                0,
                0,
                316
              ]


       We can infer that at this moment, in UTC it was November 13 (the BDT
       month is 10 and not 11, because BDT months are counted from 0), at
       06:04:00.  Furthermore, that day was a Sunday (because the weekday is
       0), which was the 316-th day of the year (where 0 is the first day).

       <?><?><?><?><?><?><?>
              jq does not allow time zone information in ISO 8601 datetime
              strings.



   fromdate, todate, fromdateiso8601, todateiso8601
       These filters convert between Unix time and ISO-8601 timestamps.

       For example, the Apollo 13 accident
       <https://en.wikipedia.org/wiki/Apollo_13#Accident>

       happened at 03:08 UTC on April 14, 1970.  Its corresponding Unix time
       is "1970-04-14T03:08:00Z" | fromdate --> 8910480.  We can get back the
       ISO-8601 timestamp via 8910480 | todate --> "1970-04-14T03:08:00Z".

       These filters can handle floating-point numbers, e.g.  0.123456 |
       todate --> "1970-01-01T00:00:00.123456Z" and
       "1970-01-01T00:00:00.123456Z" | fromdate --> 0.123456.  In particular,
       fromdate yields a floating-point number if the time cannot be
       represented losslessly as an integer.

       The filters fromdateiso8601 and todateiso8601 are synonyms of fromdate
       and todate, respectively.



   strftime($fmt), strflocaltime($fmt)
       The filters strftime($fmt) and strflocaltime($fmt) take as input either
       a number that is interpreted as Unix epoch, or a BDT array.  The
       filters yield a string representation of the input time, using the
       format $fmt.

       If the input is a Unix epoch, both strftime and strflocaltime interpret
       it as UTC timestamp.  If the input is a BDT array, then strftime
       interprets input as UTC and strflocaltime interprets input as user
       local time.  strftime outputs the time as UTC and strflocaltime outputs
       the time as user local time.

       For example, if the user is in the CET zone (+0100):


         o 0 | strftime("%T %z (%Z)") --> "00:00:00 +0000 (UTC)"


         o [1970, 0, 1, 0, 0, 0] | strftime("%T %z (%Z)") --> "00:00:00 +0000
           (UTC)"


         o 0 | strflocaltime("%T %z (%Z)") yields "01:00:00 +0100 (CET)"


         o [1970, 0, 1, 0, 0, 0] | strflocaltime("%T %z (%Z)") yields
           "00:00:00 +0100 (CET)"



       <?><?><?><?><?><?><?>
              jq prints GMT instead of UTC in the examples above; however, GMT
              is not the same as UTC.




   strptime($fmt)
       The filter strptime($fmt) takes a string and parses it using the format
       $fmt, yielding a BDT array.  If no time zone is inferred from the input
       (e.g. via %Z), it is assumed to be UTC.  For example:


         o "1970-01-01 00:00:00" | strptime("%F %T") --> [1970, 0, 1, 0, 0, 0,
           4, 0]


         o "1970-01-01 00:00:00 Europe/Vienna" | strptime("%F %T %Q") -->
           [1970, 0, 1, 0, 0, 0, 4, 0]





   gmtime, localtime
       The filters gmtime and localtime take a Unix epoch as input and yield a
       corresponding BDT array, containing the time in UTC (gmtime) or in the
       user local time (localtime).

       For example, if the user is in the CET zone (+0100):


         o 0 | gmtime --> [1970, 0, 1, 0, 0, 0, 4, 0]


         o 0 | localtime yields [1970, 0, 1, 1, 0, 0, 4, 0]





   mktime
       The filter mktime takes a BDT array that is assumed to be in UTC, and
       yields the corresponding Unix epoch.  For example, [1970, 0, 1, 0, 0,
       0] | mktime --> 0.




   <?><?><?><?><?><?><?><?><?> <?><?><?><?> (REGULAR EXPRESSIONS)
       All the filters in this section, such as test, take a string as input
       and fail if they receive any other type of value.  Furthermore, they
       all take two string arguments, namely the regular expression $re and
       the $flags that determine how the regular expression is interpreted.
       Omitting $flags is equivalent to passing "" as $flags.  For example,
       test($re) is equivalent to test($re; "").

       The supported flags are:


         o g: global search


         o n: ignore empty matches


         o i: case-insensitive


         o m: multi-line mode: ^ and $ match begin/end of line


         o s: single-line mode: allow . to match \n


         o l: greedy


         o x: extended mode: ignore whitespace and allow line comments
           (starting with #)



       <?><?><?><?><?><?><?>
              jaq uses the regex-lite <https://docs.rs/regex-lite> crate to
              compile and run regular expressions (regexes).  See the crate
              documentation for a description of the supported regex syntax.



   test
       The filter test yields true if some part of the input matches the
       regular expression, else false.  For example:


         o "jaq v3.0" | test("v[0-9]+\\.[0-9]+") --> true


         o "jaq V3.0" | test("v[0-9]+\\.[0-9]+") --> false


         o "jaq V3.0" | test("v[0-9]+\\.[0-9]+"; "i") --> true





   scan
       The filter scan yields all parts of the input that match the regular
       expression.  For example:


         o "v2.0, v3.0" | scan("v[0-9]+\\.[0-9]+"     ) --> "v2.0"


         o "v2.0, v3.0" | scan("v[0-9]+\\.[0-9]+"; "g") --> "v2.0" "v3.0"


         o "V2.0"       | scan("v[0-9]+\\.[0-9]+") --> (no output)





   match
       The filter match yields an object for every part of the input that
       matches the regular expression, containing:


         o "offset": the character index of the start of the match


         o "length": the number of characters of the match


         o "string": the contents of the match


         o "captures": an array with an object for every capture group,
           containing:


           o "offset",


           o "length",


           o "string": as above, but for the capture group instead of the
             whole match


           o "name": the name of the capture group if it has one, else this
             key is omitted





       Example:

              "v2.0, v3.0" | match("v(?<maj>[0-9]+)\\.([0-9]+)"; "g") -->
              {
                "offset": 0,
                "length": 4,
                "string": "v2.0",
                "captures": [
                  {
                    "offset": 1,
                    "length": 1,
                    "string": "2",
                    "name": "maj"
                  },
                  {
                    "offset": 3,
                    "length": 1,
                    "string": "0"
                  }
                ]
              }
              {
                "offset": 6,
                "length": 4,
                "string": "v3.0",
                "captures": [
                  {
                    "offset": 7,
                    "length": 1,
                    "string": "3",
                    "name": "maj"
                  },
                  {
                    "offset": 9,
                    "length": 1,
                    "string": "0"
                  }
                ]
              }




   capture
       The filter capture yields an object for every part of the input that
       matches the regular expression, containing for each named capture group
       an entry with the group name as key and its matched string as value.

       Example:

              "v2.0, v3.0" | capture("v(?<maj>[0-9]+)\\.(?<min>[0-9]+)"; "g") -->
              {
                "maj": "2",
                "min": "0"
              }
              {
                "maj": "3",
                "min": "0"
              }




   split, splits
       The filter split($re; $flags) yields an array of those parts of the
       input string that do not match the regular expression $re.  For
       example:


         o "Here be\tspaces" | split("\\s" ; "") --> ["Here", "be", "spaces"]


         o "  More\n\n"      | split("\\s+"; "") --> ["", "More", ""]


         o ""                | split("\\s" ; "") --> [""]



       Note that split($re; $flags) is equivalent to split($re; "g" + $flags),
       meaning that the string is split not only by the first match, but by
       all matches.  Furthermore, unlike all other filters in this section,
       split($s) is not equivalent to split($s; $flags), because split($s)
       splits a string by a separator that is not interpreted as regular
       expression; see split.

       The filter splits($re; $flags) yields the elements of the array yielded
       by split($re; $flags).  For example, "Here be\tspaces" | splits("\\s")
       --> "Here" "be" "spaces".  The filter splits($re) is equivalent to
       splits($re; "").



   sub, gsub
       The filter sub($re; f; $flags) replaces all parts of the input string
       that match $re by the output of f.  Here, f receives an object as
       returned by capture; that is, for every named capture group, it
       contains its name as key and its matched string as value.

       For example:

              "Mr. <?><?> & Mrs. <?><?>" | sub("(?<title>(Mr|Ms|Mrs)\\.) (?<name>\\S+)"; "\(.name) (\(.title))"; "g") -->
              "<?><?> (Mr.) & <?><?> (Mrs.)"


       When the filter f yields multiple outputs, then all potential
       combinations are output.  For example:

              "Thanks, fine." | sub("(?<word>\\w+)"; .word, (.word | ascii_upcase); "g") -->
              "Thanks, fine."
              "Thanks, FINE."
              "THANKS, fine."
              "THANKS, FINE."


       We have following short forms:


         o The filter gsub($re; f; $flags) is equivalent to sub($re; f; "g" +
           $flags).


         o The filter gsub($re; f) is equivalent to gsub($re; f; "").


         o The filter  sub($re; f) is equivalent to  sub($re; f; "").






   <?><?><?><?><?>/<?><?><?><?><?> (I/O)
       This section contains filters that interact with the system.  These
       filters may yield different outputs when given equal inputs.


   input, inputs
       The filter inputs yields all the inputs in the current input file.  For
       example:

              $ echo 1 2 3 | jaq -nc '[inputs]'
              [1,2,3]


       This can be useful to fold over large (potentially infinite) amounts of
       values; for example, to create a cumulative sum over all input
       integers, you can use jaq -n 'foreach inputs as $x (0; .+$x)'.

       The filter input yields the next input in the current input file.

       <?><?><?><?><?><?><?>
              When there is no more input value left, in jq, input yields an
              error, whereas in jaq, it yields no output value.  That is, in
              jaq, input is equivalent to first(inputs).





   debug, debug(f)
       The filter debug(f) prints a debug message for every output of f to the
       standard error stream (stderr), then yields its input.  For example:

              $ jaq -n '0 | debug(1, 2)'
              ["DEBUG:", 1]
              ["DEBUG:", 2]
              0


       The filter debug is equivalent to debug(.).



   stderr
       The filter stderr prints its input to the standard error stream in raw
       and compact mode without newline.  It then yields its input.

              $ jaq -n '"Hi" | stderr'
              Hi"Hi"




   halt, halt($exit_code)
       The filter halt($exit_code) terminates jaq with the given exit code.

       The filter halt terminates jaq with exit code 0.

              $ jaq -n '1, halt    , 2'
              1
              $ jaq -n '1, halt(42), 2'; echo $?
              1
              42


       <?><?><?><?><?><?><?>
              jq does not implement halt($exit_code), only halt.





   halt_error, halt_error($exit_code)
       The filter halt_error($exit_code) prints its input via stderr.  It then
       quits the jaq process with the given exit code.

       The filter halt_error is equivalent to halt_error(5).

              $ jaq -n '"Hi!" | halt_error(42)'; echo $?
              Hi!42
              $ jaq -n '"Hi!" | halt_error    '; echo $?
              Hi!5


       <?><?><?><?><?><?><?>
              jq prints a newline after the input if it is not a string.




   now
       This filter yields the Unix epoch as floating-point number.

              $ date +%s | jaq 'now - . as $dt | 0 <= $dt and $dt <= 2'
              true




   $ENV, env
       The variable $ENV holds an object that contains an entry for every
       environment variable, where the key is the name of the variable and the
       value is its value.  For example, {"EDITOR": "vim", "SHELL":
       "/usr/bin/bash"}.

              $ MYFLAG=42 jaq -n '$ENV.MYFLAG'
              "42"


       The filter env is equivalent to $ENV.



   input_filename
       The filter input_filename returns the name of the file currently read,
       or "<stdin>" if standard input is currently read.

              $ jaq --slurp 'input_filename' "examples/benches.json"
              "examples/benches.json"
              $ echo 0 | jaq 'input_filename'
              "<stdin>"


       <?><?><?><?><?><?><?>
              In jq, this filter returns the name of the file most recently
              read from.  This can lead to subtle differences compared to jaq.
              For example:

                     $ echo 0 | jaq --null-input '(., inputs) | input_filename'
                     "<stdin>"
                     "<stdin>"


              Here, jq yields null "<stdin>". Why?  When executing the filter
              ., jq did not read any input, so input_filename returns null.
              However, when executing inputs, jq starts reading from standard
              input, so input_filename returns "<stdin>".

              In contrast, jaq considers a file as being read even when it has
              only been opened.




   repl
       The filter repl starts an interactive REPL (read-eval-print-loop).  You
       can nest calls to repl; that is, you can run repl from inside a repl.
       Use CTRL-D to exit a REPL.

       This filter yields no output.  It writes its history to a file
       jaq-history in the user's cache directory.

       <?><?><?><?><?><?><?>
              This filter has been inspired by fq's repl filter.  However,
              unlike fq, jaq does not require to be started with the --repl
              flag, and it allows calls to repl anywhere in a filter, not only
              last in the pipeline.

              jq does not have this filter.





   <?><?><?><?><?><?><?><?><?><?><?><?><?> (UNSUPPORTED)
       This section lists filters present in jq, but not in jaq.


         o $__loc__ <https://jqlang.org/manual/#$__loc__>



         o modulemeta


         o have_literal_numbers
           <https://jqlang.org/manual/#have_literal_numbers>



         o have_decnum <https://jqlang.org/manual/#have_decnum>



         o $JQ_BUILD_CONFIGURATION
           <https://jqlang.org/manual/#$jq_build_configuration>



         o builtins <https://jqlang.org/manual/#builtins>



         o input_line_number <https://jqlang.org/manual/#input_line_number>




       jaq supports none of jq's SQL-style operators
       <https://jqlang.org/manual/#sql-style-operators>, mostly for aesthetic
       reasons (uppercase-names) and because jq is not SQL:


         o INDEX


         o JOIN


         o IN



       jaq does not support jq's --stream
       <https://jqlang.org/manual/#streaming> option; therefore, it also does
       not implement the related filters:


         o truncate_stream


         o fromstream


         o tostream






<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (ADVANCED FEATURES)
   <?><?><?><?><?><?><?><?><?> (ASSIGNMENTS)
       <?><?><?><?><?> jq <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?> p |= f <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?> p <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?>.  <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> jq <?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> jq <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?>:

              (.posts[] | select(.author == "stedolan") | .comments) += ["terrible."]


       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> "stedolan"
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  (<?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> -- <?><?> <?><?><?> <?><?> <?><?> <?><?> <?><?><?> jq
       <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?>.)

       <?><?><?><?><?> jaq <?> <?><?><?><?><?><?> jq <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>:


         o <?><?><?><?><?> <?><?> <?><?><?><?> (Path-based): <?><?> jq<?>
           <?><?><?><?><?><?> p |= f <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> p
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?>
           <?><?><?><?><?> f <?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>.


         o <?><?><?><?> <?><?><?><?> (Pathless): <?><?> jaq<?> <?><?>
           <?><?><?><?><?><?> p |= f <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.



       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?>: [1, 2, 3] | .[]
       |= .+1 --> [2, 3, 4]: <?><?><?><?><?><?> <?><?> jq <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> [1, 2, 3] | path(.[]) --> [0] [1] [2] <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?> .+1 <?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?> <?><?><?> <?><?><?><?><?> jaq <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>: [1, 2, 3] | [.[] | .+1] --> [2, 3,
       4] -- <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?> <?><?> <?><?><?><?> jq <?> jaq <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.


   <?><?><?><?><?> <?><?> <?><?><?><?> (Path-based)
       <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?> jq <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> p |= u <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> p<?> <?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?> u
       <?><?><?><?> <?><?><?><?><?><?>.  <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?> getpath(path(p)) |= u
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> --
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?> jq <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?>.


       <?><?><?><?><?><?><?><?> reduce / foreach <?><?> <?><?> <?><?> jaq
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> f
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> path(f)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?>.  <?><?><?><?><?><?><?><?><?> <?><?> jaq<?>
       <?><?><?><?><?><?><?><?><?> <?><?> reduce / foreach <?><?><?><?>
       path(f) <?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:


         o [{a: 1}] | path(reduce  (0, "a") as $i (.; .[$i])) -->     [0, "a"]


         o [{a: 1}] | path(foreach (0, "a") as $i (.; .[$i])) --> [0] [0, "a"]



       <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>:


         o [1, 2, 3]   | path(.[]?) --> [0] [1] [2]


         o ""          | path(.[]?) --> (<?><?><?><?> <?><?><?><?><?>)


         o {a: [1, 2]} | path(.a[]) --> ["a", 0] ["a", 1]



       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?>:


         o try path(0    ) catch "fail" --> "fail"


         o try path(1 + 2) catch "fail" --> "fail"


         o try path(1 = 2) catch "fail" --> "fail"



       <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> jq <?><?> reduce / foreach <?><?> path
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

              <?><?> <?><?><?> <?><?><?><?><?> jq <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?>.  <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> try path([] | empty) catch
              "fail" --> "fail"<?> <?><?><?><?> jaq <?><?><?><?><?> path([] |
              empty) <?><?> <?><?> path([]) as $p | ... <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> path([]) <?><?><?><?><?> <?><?><?><?> <?><?><?>.
              <?><?> <?><?><?><?><?><?> jq <?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> path([] | .[]) <?><?> <?><?> <?><?> <?><?><?><?> jaq <?>
              jq <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?> empty
              <?><?><?> <?><?><?><?><?><?><?>.

              <?><?> jaq<?> <?><?><?><?><?> [] | path(.[0: ]) --> [{"start":
              0}] <?> [] | path(.[ :0]) --> [{"end"  : 0}] <?><?><?><?> <?><?>
              <?><?><?><?> <?><?> jq <?><?> <?><?><?><?><?> [{start: 0   ,
              end: null}] <?> [{start: null, end: 0   }] <?><?>
              <?><?><?><?><?><?><?><?><?><?><?>.  <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?> jq <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> start/end
              <?><?> <?><?> <?><?><?><?><?> null <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> jaq
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>.




   <?><?><?><?> <?><?><?><?> (Pathless)
       <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> jaq <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> p |= u <?><?>
       <?><?><?><?> <?><?> p <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?>:


         o <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.


         o <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> u <?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?>
           <?><?><?><?><?>: 0 | (., .) |= (., .+1) --> 0 1 1 2 <?><?> jaq<?>
           <?><?> <?><?><?><?> <?><?> <?><?> jq <?><?><?><?> <?><?><?><?><?> 0
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?> <?><?><?>
           <?><?><?><?> {a: 1} | .a |= (2, 3) --> {"a": 2} <?><?> <?><?>
           <?><?> jaq <?> jq <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?>.


         o <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?> (iterator invalidation) <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>.



       <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>:


         o try f catch g


         o first(f)<?> last(f)


         o limit($n; f)


         o skip($n; f)



       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?> jaq <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?>:


         o [1, 2, 3] | try      .[]  -= 1 <?><?> jq <?><?><?><?><?> [0, 1, 2]
           <?><?><?><?><?><?>.


         o [1, 2, 3] | first(   .[]) -= 1 <?><?> jq <?><?><?><?><?> [0, 2, 3]
           <?><?><?><?><?><?>.


         o [1, 2, 3] | limit(2; .[]) -= 1 <?><?> jq <?><?><?><?><?> [0, 1, 3]
           <?><?><?><?><?><?>.


         o [1, 2, 3] | skip (1; .[]) -= 1 <?><?> jq <?><?><?><?><?> [1, 1, 2]
           <?><?><?><?><?><?>.


         o [1, 2, 3] | last (   .[]) -= 1 <?><?> jq <?><?><?>
           <?><?><?><?><?><?>.



       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> getpath(path(p)) |= u <?><?> <?><?><?> p |= u
       <?><?> jaq <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> jaq <?> jq
       <?><?><?><?><?> <?><?><?><?><?><?><?>:


         o [1, 2, 3] | getpath(path(try      .[] )) -= 1 --> [0, 1, 2]


         o [1, 2, 3] | getpath(path(first(   .[]))) -= 1 --> [0, 2, 3]


         o [1, 2, 3] | getpath(path(limit(2; .[]))) -= 1 --> [0, 1, 3]


         o [1, 2, 3] | getpath(path(skip (1; .[]))) -= 1 --> [1, 1, 2]


         o [1, 2, 3] | getpath(path(last (   .[]))) -= 1 --> [1, 2, 2]
           (<?><?><?> <?><?><?><?> <?><?> jq <?><?><?> <?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?> <?><?> jaq <?><?><?> <?><?><?><?><?><?>)




       <?><?><?><?><?><?><?>
              <?><?> jq<?> <?><?><?><?><?> . |= empty <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> null <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?> jaq <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?> jq<?> <?><?><?><?><?> . |=
              (., .) <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?> jaq <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?>.

              <?><?> jq<?> <?><?><?><?><?> [0, 1] | .[3] = 3 <?><?><?><?><?>
              [0, 1, null, 3] <?><?> <?><?><?><?><?><?><?> <?><?><?><?> jq
              <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?> <?><?><?><?><?><?> null <?><?> <?><?><?><?><?><?>.
              <?><?> <?><?><?><?><?><?> jaq <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> (out-of-bounds) <?><?><?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?><?><?><?> jq <?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> jaq
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

              <?><?> jq<?> null | .a   = 1 <?><?><?><?><?> {"a": 1} <?> null |
              .[0] = 1 <?><?><?><?><?> [1] <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?> jq <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> null <?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?>
              <?><?><?><?> <?><?> jaq <?><?> <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?> null | .[0] = 1 <?><?><?><?>
              <?><?><?><?><?> {0: 1} <?><?> [1] <?><?> <?><?><?><?><?>
              <?><?><?>.  <?><?> <?><?><?><?> <?><?><?><?><?> jaq <?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> null <?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?>.





   <?><?><?><?><?><?> (PATTERNS)
       <?><?><?><?><?> f as $x | g <?><?><?><?><?><?><?><?><?> f <?><?> <?><?>
       <?><?> <?><?><?><?><?> $x <?><?><?><?> <?><?><?><?><?><?><?>.  <?><?>
       <?><?><?><?><?><?> $x<?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> (pattern) <?><?><?><?> <?><?><?><?><?> /
       <?><?><?><?><?><?><?><?><?><?> (destructure) <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?>:

              [ 1, {a:  2}] |
              .[0]   as $x  |
              .[1].a as $y  |
              $x, $y -->
               1   2


       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>:

              [ 1, {a:  2}] as
              [$x, {a: $y}] |
               $x,     $y -->
                1       2


       <?><?> <?><?><?><?><?><?> [$x, {a: $y}] <?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> [1, {a: 2}]
       <?><?> <?><?><?> <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?> 1 <?><?>
       <?><?> $x <?> 2 <?><?> <?><?> $y <?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> {$x} <?><?><?><?><?>
       <?><?> {x: $x} <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>: [1, {a:
       2}] as [$x, {$a}] | $x, $a --> 1 2

       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> null
       <?><?><?><?> <?><?><?><?><?><?><?>:


         o [1, {b: 2}] as [$x, {$a}] | $x, $a --> 1 null


         o [1        ] as [$x,   $y] | $x, $y --> 1 null


         o [1, {a: 2}] as [$x, [$y]] | $x, $y --> 1 null



       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?>:


         o try ([1] as {$a} | $a) catch "fail" --> "fail"


         o try ( 1  as [$x] | $x) catch "fail" --> "fail"



       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>:


         o [   1,    2] as [$x] | $x --> 1


         o {a: 1, b: 2} as {$a} | $a --> 1



       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>:


         o {a: [1, {b: [2]}]} as {a: [$x, {b: [$y]}]} | $x, $y --> 1 2


         o [[[1]]] as [[[$x]]] | $x --> 1


         o {a: {b: {c: 1}}} as {a: {b: {c: $x}}} | $x --> 1



       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> (f) <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>:

              {a: 1, b: 2, c: 3, d: 4} as
              {("a",  "b"): $x, ("c", "d"): $y} |
              [$x, $y] -->
              [1, 3] [1, 4] [2, 3] [2, 4]


       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> reduce <?> foreach <?><?><?><?><?><?><?>
       <?><?><?><?>:

              [{"a": 1, "b": 2}, {"a": 3, "b": 4}] |
              foreach .[] as {("a", "b"): $x} ([]; . + [$x]) -->
              [1]
              [1,2]
              [1,2,3]
              [1,2,3,4]


       <?><?><?><?><?><?><?>
              <?><?><?><?><?> jaq <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> jq ?//
              <https://jqlang.org/manual/#destructuring-alternative-operator>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.





   <?><?><?><?><?><?><?><?> (MODULES)
       <?><?><?><?><?> jq <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> jq<?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?> (<?><?><?><?><?><?><?><?> <?><?><?><?>) <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?> <?><?><?><?>
       --from-file <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>)
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       include/import <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.


   <?><?><?><?><?><?><?><?> <?><?><?><?><?> (Module metadata)
       <?><?><?><?><?><?><?><?><?><?> module meta; <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> meta
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> meta <?><?>
       <?><?><?><?><?> <?><?><?>.  <?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?>.

       <?><?><?><?> <?><?><?><?><?>: module "My module"; 1 --> 1.

       <?><?><?><?><?><?><?>
              <?><?><?><?><?> jaq <?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> jq <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> meta <?><?> <?><?><?><?>
              <?><?><?><?><?> modulemeta <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.




   <?><?><?><?><?><?><?> <?><?><?><?><?> (Module inclusion)
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> include "mod"; <?> include
       "mod" meta; <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> mod.jq <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?> <?><?><?> foo.jq <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> def bar: 1; <?><?><?><?><?>
       <?><?><?><?><?> jaq -L . -n 'include "foo"; bar' <?><?><?><?><?> 1
       <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>.



   <?><?><?><?> <?><?><?><?> <?><?><?><?><?> (Module import)
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> import "mod" as name; <?>
       import "mod" as name meta; <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> mod.jq <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?> name:: <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?>:

              $ echo 'def bar: 1;' > foo.jq && jaq -L . -n 'import "foo" as myfoo; myfoo::bar' && rm foo.jq
              1




   <?><?><?><?> <?><?><?><?> <?><?><?><?> (Data import)
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> import "data" as $name; <?>
       import "data" as $name meta; <?><?><?><?> <?><?><?><?><?><?> JSON
       <?><?> data.json <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?> $name <?><?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?>:

              $ echo 1 2 3 > foo.json && jaq -L . -nc 'import "foo.json" as $myfoo; $myfoo' && rm foo.json
              [1,2,3]




   <?><?><?><?><?><?><?> <?><?><?><?><?> (Search paths)
       <?><?><?><?><?><?><?><?><?><?> include/import <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:


         o <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> --library-path.
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?>.


         o <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>:
           <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
           include/import <?><?><?><?><?> meta <?><?> <?><?><?> {..., search:
           ..., ...} <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> "search" <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>:


           o <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>:
             <?><?><?> <?><?><?><?> <?><?><?><?>.


           o <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>:
             <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
             <?><?><?><?><?>.


           o <?><?> <?><?><?> <?><?><?> <?><?><?><?>: <?><?><?><?><?><?><?>.


         <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
         include/import <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
         <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
         <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
         <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?>
         <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
         <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
         <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.
         (<?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
         <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
         include/import <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
         <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>.)



       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>:


         o <?><?><?> <?><?> ~ <?><?><?><?> <?><?><?><?> ~ <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> HOME <?><?>
           <?><?><?><?><?><?> <?> USERPROFILE <?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?>.


         o <?><?><?> <?><?> $ORIGIN <?><?><?><?> <?><?><?><?> $ORIGIN <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> jaq
           <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.



       <?><?><?><?> <?><?><?><?><?>: jaq -L ~/foo -L bar 'include "decode"
       {search: ["baz", "$ORIGIN/quux"]}; 1' <?><?><?><?> decode.jq <?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:


         o ~/foo/decode.jq (<?><?> <?><?> <?><?> ~ <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>)


         o ./bar/decode.jq


         o ./baz/decode.jq


         o $ORIGIN/quux/decode.jq (<?><?> <?><?> <?><?> $ORIGIN <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> jaq <?><?><?><?><?><?><?> <?><?><?><?><?><?>)



       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?> <?><?><?> <?><?><?><?> <?><?> decode.jq <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> import "binary" as $binary {search: "."}
       <?><?><?><?>.  <?><?><?> <?><?><?><?><?> binary.json <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:


         o ~/foo/binary.json


         o ./bar/binary.json (<?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?>)


         o ./binary.json (<?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           decode.jq)



       <?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> decode <?> binary <?><?>
              <?><?><?><?><?> <?><?><?><?><?> jaq <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> (.jq <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> .json <?><?><?><?>
              <?><?><?><?><?><?><?>).  <?><?><?><?><?><?> jq <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?> <?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> jq
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?><?><?><?> <?><?><?><?><?> jaq
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              import "binary.cbor" as $binary <?><?> <?><?><?><?><?>
              <?><?><?>.  <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?> <?><?><?><?><?>
              .json <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>.





   <?><?><?><?><?><?><?> / <?><?><?><?><?><?><?><?> (COMMENTS)
       <?><?> <?><?><?><?><?> (comment) <?><?> # <?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> (\) <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:

              [
                1,
                # comment
                2,
                # comment \\
                3,
                # comment \
                  comment
                4,
                # comment \\\
                  comment \
                  comment
                5
              ]


       <?><?><?> <?><?><?><?><?> <?><?> [1, 2, 3, 4, 5] <?><?><?>.

<?><?><?><?><?><?><?> (FORMATS)
       <?><?><?><?><?> jaq <?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?>:


         o <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> --from / --to<?>
           <?><?>


         o <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> fromjson <?>
           toyaml



       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> --from <?> --to
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.


   JSON
       JSON <https://www.json.org> (<?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>) <?><?> RFC 8259
       <https://datatracker.ietf.org/doc/html/rfc8259> <?><?><?><?> <?><?><?>
       <?><?><?>.

       <?><?><?><?><?> jaq <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> JSON <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> jq<?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> JSON
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> XJON <?><?><?><?><?> <?><?><?>
       <?><?><?>.



   XJON
       <?><?><?><?> <?><?><?><?> <?><?><?><?> jaq <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> JSON <?><?><?> <?><?> XJON
       <?><?><?><?><?><?> <?><?><?><?><?><?> (eXtended JavaScript Object
       Notation<?> <?><?><?><?> <?><?><?><?><?> "<?><?><?><?>").

       <?><?><?><?> XJON <?><?><?><?><?><?><?><?><?> JSON <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>:


         o <?><?><?><?><?><?><?><?><?> <?><?><?>: # ... \n <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>


         o <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>: NaN<?>
           Infinity<?> +Infinity<?> -Infinity


         o <?><?><?><?><?><?> <?><?> <?><?> + <?><?> <?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?>: <?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?> XJON <?><?> <?><?><?><?><?> <?><?><?><?> [+-]?\d+
           <?> <?><?> JSON <?><?> -?(0|[1-9]\d*) <?><?><?><?><?><?>
           <?><?><?><?>.  <?><?><?><?> <?><?><?><?> <?><?> <?><?> XJON<?>
           +7.1<?> 007<?> -042 <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> JSON
           <?><?><?><?><?><?><?><?><?>.


         o <?><?><?><?><?><?><?><?> UTF-8 <?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?>: <?><?><?><?><?><?><?><?><?> JSON <?><?>
           <?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> UTF-8
           <?><?><?><?><?> <?><?> <?><?><?>.  <?><?><?><?> XJON
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?> UTF-8
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> printf '"\xFF"'.  <?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> (<?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?>) <?><?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?> <?><?><?><?> --rawfile <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?> jq <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> UTF-8 <?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?><?>.


         o <?><?><?><?><?><?><?><?> <?><?><?><?><?>: <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> b"..." <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> ...
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?>:


           o <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> 0x20 <?><?>
             (<?><?><?><?>) 0xFF<?> <?><?> <?><?><?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?><?><?> '"' <?> '\'


           o <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?>
             <?><?><?><?><?><?><?> ('\') <?><?><?><?> <?><?><?> <?> <?><?>
             <?><?> <?><?> b<?> f<?> n<?> r<?> t<?> '"'<?> '\'<?> <?><?> xHH
             <?><?><?><?><?><?> <?><?> <?><?> <?><?> HH <?><?> <?><?><?>
             <?><?><?><?><?><?><?><?><?><?> <?><?><?>.  <?><?><?><?>
             <?><?><?><?><?>: b"Here comes \xFF, dadadada\nHere comes
             \xFF\nAnd I say: \"It's alright\"\x00".  <?><?><?><?><?><?><?><?>
             <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
             <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?>
             <?><?><?><?><?><?> (<?><?> <?><?><?><?><?><?> b) <?>
             <?><?><?><?><?><?><?><?><?><?><?> <?> C (<?><?><?><?>
             <?><?><?><?><?><?> b).




         o <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?>: <?><?> <?><?><?><?> <?><?> JSON
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> XJON
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>.  <?><?><?><?>
           <?><?><?><?><?>: {null: 0, true: 1, 2: 3, "str": 4, ["arr"]: 5, {}:
           6}



       <?><?><?> <?><?> <?><?><?><?><?> XJON <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> YAML <?> CBOR <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> JSON.

       <?><?><?><?> XJON <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> jaq
       <?><?> <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> XJON <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>:


         o nan |        .          | isnan --> true <?><?> jaq <?> jq


         o nan | tojson | fromjson | isnan --> true <?><?> jaq<?> <?><?><?>
           false <?><?> jq



       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> tojson | fromjson
       <?><?> jaq <?><?><?><?><?> <?><?> . <?><?><?><?> <?><?> <?><?><?><?>
       <?><?> <?><?> jq <?><?><?><?><?> \f[I]<?><?><?><?>\f[R]<?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> NaN <?> Infinity.

       <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?> jaq <?><?><?><?><?>
       JSON <?><?><?><?><?><?><?><?><?> XJON <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?>.  <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> jaq <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> JSON <?><?><?><?><?>
       <?><?><?><?><?><?>:

              $ echo 'NaN b"Bytes" {1: 2} # Over and out' | jaq --from json -c
              NaN
              b"Bytes"
              {1:2}




   YAML
       YAML <https://yaml.org> (YAML Ain't Markup Languagetm) <<<?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>>>
       <?><?><?>.  <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> JSON <?> XJON <?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> jaq <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> YAML <?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> jaq <?><?> <?><?><?><?><?><?> YAML <?><?>
       <?><?><?><?><?><?> / <?><?><?><?><?><?> (&foo) <?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> (*foo)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.  <?><?> <?><?><?>
       <?><?><?><?> jaq <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?>:


         o "[&a 1, &b 2, *a, *b]" | fromyaml --> [1, 2, 1, 2]


         o "[&b [&a [], *a], *b]" | fromyaml --> [[[], []], [[], []]]


         o "&a[*a]" | try fromyaml catch -1 --> -1



       <?><?><?><?><?> jaq <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> YAML <?><?><?><?><?> null<?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>:


         o "!!bool true" | fromyaml --> true


         o "!!int  true" | try fromyaml catch "fail" --> "fail"



       <?><?> <?><?><?> <?><?><?><?><?> jaq <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>:


         o "!!foo []" | fromyaml --> []


         o "!!bar {}" | fromyaml --> {}



       <?><?><?><?><?> jaq <?><?><?><?><?> YAML <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> JSON/XJON <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?><?><?><?> YAML <?><?> jaq <?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?> XJON <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> Base64 <?><?> <?><?> !!binary <?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?> .inf<?> -.inf <?> .nan <?><?><?><?><?><?><?><?>:

              [infinite, -infinite, nan, ("a" | tobytes), {"a": 1}] | tojson, toyaml -->
              "[Infinity,-Infinity,NaN,b\"a\",{\"a\":1}]"
              "[.inf, -.inf, .nan, !!binary YQ==, {a: 1}]"


       <?><?><?><?><?> jaq <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       UTF-8 <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> YAML <?><?><?> <?><?><?><?><?><?>.
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> YAML <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> UTF-8 <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> --to yaml<?>
       <?><?><?><?><?> jaq <?><?><?><?><?> --- <?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?> ... <?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.  <?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?> YAML <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?>:

              $ jaq -n '[1, {a: 2, b: [3]}]' --to yaml
              ---
              - 1
              -
                a: 2
                b:
                  - 3
              ...
              $ echo 1 2 | jaq --to yaml
              ---
              1
              ...
              ---
              2
              ...


       <?><?> <?><?><?><?><?> -j <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?>/<?><?><?><?><?> <?><?><?> YAML
       <?><?><?><?><?><?><?> <?><?><?><?>.  <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?>:

              $ echo '[1, 2] [3, 4]' | jaq --to yaml -j
              - 1
              - 2
              - 3
              - 4


       <?><?> <?><?> <?><?><?><?><?> --from yaml <?> <?><?><?><?><?> fromyaml
       <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.



   CBOR
       CBOR <https://cbor.io> (Concise Binary Object Representation) <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?> RFC 8949
       <https://www.rfc-editor.org/rfc/rfc8949.html> <?><?><?><?> <?><?><?>
       <?><?><?>.

       <?><?><?><?><?><?> CBOR <?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> jaq <?><?><?><?><?>.  <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> CBOR
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> jaq <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>:


         o <?><?><?><?><?>-<?><?><?><?> (date-time)
           <https://www.rfc-editor.org/rfc/rfc8949.html#name-epoch-based-date-time>



         o <?><?><?><?><?><?><?><?><?><?> (undefined)
           <https://www.rfc-editor.org/rfc/rfc8949.html#name-undefined-values>



         o <?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> (bigfloats)
           <https://www.rfc-editor.org/rfc/rfc8949.html#fractions>




       <?><?><?><?><?> jaq <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> CBOR <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?> <?><?><?><?><?> jaq <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> CBOR
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> UTF-8.
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> UTF-8 <?><?> U+FFFD
       <?><?> <?><?><?><?> <?><?><?> <?><?><?>: "" <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?><?> jaq <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> CBOR
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.  <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> --to cbor <?><?><?><?><?> <?><?>
       --to cbor --join-output <?><?><?>.  <?><?><?><?><?> jaq
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> CBOR <?><?> <?><?><?><?><?><?>.



   TOML
       TOML <https://toml.io> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?>.  <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> TOML <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> JSON <?><?><?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?>:

              $ jaq '.profile.release["codegen-units"]' Cargo.toml
              1


       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> TOML <?><?><?> <?><?><?><?><?><?><?>:

              $ echo 'a = {b = 1, c = {d = nan, e = [], f = [{g = inf}, {h = -inf}]}}' | jaq --from toml --to toml
              [a]
              b = 1

              [a.c]
              d = nan
              e = []

              [[a.c.f]]
              g = inf

              [[a.c.f]]
              h = -inf


       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> jaq<?> <?><?><?><?>
       TOML <?><?><?><?><?><?> <?><?><?><?><?>-<?><?><?><?> <?><?><?><?><?>
       <?><?><?> TOML <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> null<?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?>.  <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> TOML <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>.
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> TOML
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>:


         o 0                | try totoml catch -1 --> -1 (<?><?><?><?>
           <?><?><?><?><?><?>)


         o {a: null       } | try totoml catch -1 --> -1 (<?><?><?><?><?>
           null)


         o {a: 0 | tobytes} | try totoml catch -1 --> -1 (<?><?><?><?>
           <?><?><?><?><?>)


         o {(1): 2        } | try totoml catch -1 --> -1 (<?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?><?>)



       <?><?><?><?><?> jaq <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> TOML
       1.1.0 <https://toml.io/en/v1.1.0> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>-<?><?><?><?>.
       <?><?><?><?><?> jaq <?><?> <?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> TOML <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       (big integers).  <?><?><?><?> <?><?><?> <?><?> <?><?><?> {a: 2^1024}
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> TOML <?><?><?><?><?><?><?><?><?> <?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>:

       {a: nth(1024; 1 | recurse(.*2))} | totoml | try fromtoml catch -1 -->
       -1

       <?><?><?><?><?> <?><?><?><?><?> TOML<?> <?><?><?><?><?> jaq
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> UTF-8 <?><?>
       <?><?><?><?><?> CBOR <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       TOML <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>:

       {a: [-255] | implode} | (totoml | fromtoml) == . --> false



   XML
       <?><?><?><?><?> jaq <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> XML 1.0 <https://www.w3.org/TR/xml> <?><?>
       <?><?><?><?><?><?><?><?>.  <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> XML <?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> UTF-8 <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> jaq <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       XHTML <?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> HTML <?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> html2xhtml <https://github.com/jfisteus/html2xhtml>
       <?><?><?><?> <?><?><?><?><?> HTML <?><?> XHTML <?><?><?><?><?><?><?>
       <?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?><?> XML <?> JSON <?><?> <?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?> <<<?><?><?><?><?><?><?><?><?>
       <?><?><?><?>>> (friendliness) <?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> (round-tripping) <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <<Experiences with JSON and XML
       Transformations
       <https://www.w3.org/2011/10/integration-workshop/p/XML_JSON_mapping_paper.pdf>>>.
       <?><?> <?><?><?><?><?><?> <<<?><?><?><?><?><?><?><?><?> <?><?><?><?>>>
       <?><?><?><?> <?><?><?><?> <?><?><?> <?><?> JSON
       <?><?><?><?><?><?><?><?> <?><?> XML <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <<<?><?><?><?><?><?><?><?><?>>>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <<Converting Between XML
       and JSON
       <https://www.xml.com/pub/a/2006/05/31/converting-between-xml-and-json.html>>>
       <?><?><?><?><?> <?><?><?><?> <?><?><?>.  <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?>: <?><?><?><?><?><?><?><?><?>
       <<<?><?><?><?><?><?><?><?><?>>> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?>.  <?><?> <?><?><?><?> <?><?><?><?><?>
       jaq <?><?> <?><?><?><?><?> <<<?><?><?><?><?><?><?><?><?>>>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> XML <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (round-tripping)
       <?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?> <?><?> <?><?><?> <?><?><?><?><?><?>:

              <a href="https://www.w3.org">World Wide Web Consortium (<em>W3C</em>)</a>


       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?> jaq <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>:

              $ echo '<a href="https://www.w3.org">World Wide Web Consortium (<em>W3C</em>)</a>' \
              | jaq --from xml .
              {
                "t": "a",
                "a": {
                  "href": "https://www.w3.org"
                },
                "c": [
                  "World Wide Web Consortium (",
                  {
                    "t": "em",
                    "c": [
                      "W3C"
                    ]
                  },
                  ")"
                ]
              }



   <?><?><?><?><?> TAC (TAC objects)
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> TAC <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?>. <?><?> <?><?><?> TAC
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?>:


         o t: <?><?><?> <?><?><?> <?><?><?><?><?> h1 <?><?><?><?>
           <h1>...</h1>.  <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?> <?><?><?> TAC <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.


         o a: <?><?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?> {"id": "foo", style: "color:blue;"}.  <?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?>.


         o c: <?><?><?><?><?><?><?> <?><?>.  <?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> (self-closing<?> <?><?><?><?><?>
           <br/>) <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?><?>
           <?><?> <?><?> <?><?><?> TAC <?><?><?><?><?><?><?><?> <?><?><?><?>
           jaq (<?><?> <?><?> <?><?><?><?> --from xml <?><?> fromxml)
           <?><?><?><?><?> <?><?><?><?> c <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> XML <?><?>
           <?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> XML (<?><?> <?><?> <?><?><?><?> --to xml <?><?>
           toxml)<?> <?><?><?><?><?> jaq <?><?> <?><?><?><?><?> XML <?><?>
           <?><?> <?><?><?><?> c <?><?><?><?><?><?><?><?>.



       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> XHTML:

              .. | select(.t? == "a") | .a.href


       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> XML
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?> XML
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.  <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> em <?><?> <?><?><?><?><?><?> i:

              (.. | select(.t? == "em") | .t) = "i"


       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> XML <?><?> <?><?><?>
       <?><?><?><?><?> JSON<?> <?><?> <?><?><?><?><?> --to xml
       <?><?><?><?><?><?><?> <?><?><?><?>:

              $ echo '<a href="https://www.w3.org">World Wide Web Consortium (<em>W3C</em>)</a>' \
              | jaq --from xml --to xml '(.. | select(.t? == "em") | .t) = "i"'
              <a href="https://www.w3.org">World Wide Web Consortium (<i>W3C</i>)</a>


       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> XML <?><?><?><?><?><?><?>
       <?><?><?><?> (<?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> CDATA):

              def xml_text: if isstring then . else .c[]? | xml_text end; [xml_text]




   <?><?><?><?> <?><?><?><?><?><?> (Other values)


         o <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> Tom &amp; Jerry <?><?> XML <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> "Tom &amp; Jerry" <?><?>
           JSON <?><?><?><?>.  <?><?><?><?><?><?><?><?> @html/@htmld
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?>.


         o <?><?> <?><?><?><?><?> <?><?><?><?><?> <!-- this comment -->
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> {"comment": " this
           comment "}.


         o <?><?> <?><?><?><?> CDATA <?><?><?><?><?> <![CDATA[Tom & Jerry]]>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> {"cdata": "Tom & Jerry"}.


         o <?><?> <?><?><?><?><?> XML <?><?><?><?><?> <?xml version="1.0"
           encoding="UTF-8" standalone="yes"?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> {"xmldecl": {"version": "1.0",
           "encoding": "UTF-8", "standalone": "yes"}}.  (<?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> XML <?><?> jaq <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?>.)


         o <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (PI)
           <?><?><?><?><?> <?xml-stylesheet href="common.css"?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> {"pi": {"target":
           "xml-stylesheet", "content": "href=\"common.css\""}}.



       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> XML <?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?>:

              $ cat examples/test.xhtml
              <?xml version='1.0'?>
              <?xml-stylesheet href="common.css"?>
              <!DOCTYPE html>
              <html xmlns="http://www.w3.org/1999/xhtml">
                <body>
                  <!-- CDATA blocks do not require escaping -->
                  <![CDATA[Hello & goodbye!]]><br/>
                </body>
              </html>


       <?><?><?> <?><?><?><?><?> <?><?> jaq <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?>:

              $ jaq . examples/test.xhtml
              {
                "xmldecl": {
                  "version": "1.0"
                }
              }
              {
                "pi": {
                  "target": "xml-stylesheet",
                  "content": "href=\"common.css\""
                }
              }
              {
                "doctype": {
                  "name": "html"
                }
              }
              {
                "t": "html",
                "a": {
                  "xmlns": "http://www.w3.org/1999/xhtml"
                },
                "c": [
                  "\n  ",
                  {
                    "t": "body",
                    "c": [
                      "\n    ",
                      {
                        "comment": " CDATA blocks do not require escaping "
                      },
                      "\n    ",
                      {
                        "cdata": "Hello & goodbye!"
                      },
                      {
                        "t": "br"
                      },
                      "\n  "
                    ]
                  },
                  "\n"
                ]
              }


       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       "\n    ".  <?><?><?> <?><?><?><?><?><?> <?><?><?><?> jaq <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> XML <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>.




   CSV / TSV
       CSV <https://www.rfc-editor.org/rfc/rfc4180> (<?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?>) <?> TSV (<?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?>) <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>.  <?><?> <?><?><?><?> CSV/TSV <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?>.  <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?><?><?> <?><?> CSV <?><?> <?><?><?><?> <?> <?><?> TSV <?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.

       <?><?><?><?><?> jaq <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>:

              $ printf "a,b\n1,2\n3,4" | jaq -c --from csv
              ["a","b"]
              [1,2]
              [3,4]
              $ printf "a,b\n1,2\n3,4" | jaq -c --from csv --slurp
              [["a","b"],[1,2],[3,4]]


       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> --to<?> <?><?><?><?><?> jaq
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> tocsv / totsv <?><?>
       <?><?><?> <?><?><?><?><?><?>:

              $ jaq -n '["a","b"], [1,2], [3,4]' --to csv
              "a","b"
              1,2
              3,4
              $ jaq -n '["a","b"], [1,2], [3,4] | @csv' --raw-output
              "a","b"
              1,2
              3,4



   <?><?><?><?><?><?><?><?><?> (Headers)
       <?><?><?><?><?> jaq <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?>.  <?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> examples/table.jq <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?>.  <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <https://github.com/01mf02/jaq/issues/418> <?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> jaq <?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <https://en.wikipedia.org/wiki/Ferris_Bueller%27s_Day_Off>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?>:

              $ cat examples/ferris.csv
              ID,Name,Home phone,Days absent
              38-106,"Bueller, Ferris",555-6452,9


       <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?> <?><?>. <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?>.  <?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?>:

              $ jaq -L examples 'include "table"; from_table' -s examples/ferris.csv
              {
                "ID": "38-106",
                "Name": "Bueller, Ferris",
                "Home phone": "555-6452",
                "Days absent": 9
              }


       <?><?><?><?><?> <?><?><?><?> <?><?>. <?><?><?><?> <?><?><?><?><?><?>
       <?><?>. <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>


              <<<?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?>.>> -- <<<?><?><?>
              <?><?><?><?>>> -- <<<?><?><?> <?><?><?>.>> -- <<<?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?>.>> -- <<<?><?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.>> --
              <<<?><?><?><?><?> <?><?><?><?><?>.>> -- <<<?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?>.>>


       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>:

              $ jaq -L examples 'include "table"; from_table | .["Days absent"] -= 7' -s examples/ferris.csv
              {
                "ID": "38-106",
                "Name": "Bueller, Ferris",
                "Home phone": "555-6452",
                "Days absent": 2
              }



              <<<?><?><?><?>! <?><?><?><?><?><?><?><?>!!!>>


       <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?>:

              $ cat examples/ferris-courses.tsv
              Perds     Days Course    Teacher   Rm   Grade 1   Grade 2   Grade 3   Grade EX
              01-04     MTWF Eng Comp  Hollndr   221  B+   A
              05-08     MWTF Calculus  McMurry   309  B    A-
              09-10     TWTF Chemistry Gunner    260  A-   A
              11-13     All  Lunch          Caf
              14-19     MTWF Gym  Carlyle   127  B+   A-
              23-25     TWTF Computr Sc     Cohen     114  A-   A
              26-29     MWTF Utpian Scy     Jardin    241  A    A
              30-32     MTWF Euro Hist Rice 334  B+   B+


       <?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> +B <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?>

              $ jaq -L examples 'include "table"; with_table(map(select(.["Grade 1"] == "B+")))' \
                -s examples/ferris-courses.tsv --to tsv
              Perds     Days Course    Teacher   Rm   Grade 1   Grade 2   Grade 3   Grade EX
              01-04     MTWF Eng Comp  Hollndr   221  B+   A
              14-19     MTWF Gym  Carlyle   127  B+   A-
              30-32     MTWF Euro Hist Rice 334  B+   B+


       <?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       -s <?><?><?><?><?><?><?><?> (slurp) <?><?><?><?><?>.  <?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.  <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>: <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> inputs <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> -n <?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> (= <?><?><?><?><?><?>) <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       inputs <?><?><?><?><?><?><?> <?><?><?><?>.  <?><?> <?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?>:

              $ jaq -L examples 'include "table"; ., . as $header | from_row(inputs) | select(.["Grade 1"] == "B+") | to_row($header)' \
                examples/ferris-courses.tsv --to tsv
              Perds     Days Course    Teacher   Rm   Grade 1   Grade 2   Grade 3   Grade EX
              01-04     MTWF Eng Comp  Hollndr   221  B+   A
              14-19     MTWF Gym  Carlyle   127  B+   A-
              30-32     MTWF Euro Hist Rice 334  B+   B+


       <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.  <?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.  <?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>: <<<?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?>.>>

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?> jaq <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>.
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> jaq <?><?> jq <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>:

              $ echo '{"a": 1, "b": 2}' | jaq '.a'
              1


       <?><?><?> <?><?><?><?><?><?>:

              $ echo '{"a": 1, "b": 2}' | jaq 'add'
              3


       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?>
       <?><?> <?><?><?> <?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?>:

              $ echo '{"a": 1, "b": 2}' | jaq '[.a, .b] == [.[]]'
              true


       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>:

              $ echo '[0, 1, 2, 3]' | jaq -c 'map(.*2) | [.[] | select(. < 5)]'
              [0,2,4]


       <?><?><?><?><?><?> (slurp) <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>:

              $ echo '1 2 3 4' | jaq -s 'add / length'
              2.5


       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>:

              $ echo '0' | jaq -c '[recurse(.+1; . < 3)]'
              [0,1,2]


       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (lazy fold) <?><?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>:

              $ seq 5 | jaq -n 'foreach inputs as $x (0; . + $x)'
              1
              3
              6
              10
              15



   <?><?><?><?><?> <?><?><?><?><?> (LEWIS'S PUZZLE)
       <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> jq
       <?><?> <?><?><?><?>.  <?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?>:

       <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?>:

              X
              XYZX
              XYZXABXYZX


       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?> (<?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?>) <?><?><?> `A' <?><?><?>.  <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>

       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.

       <?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>:

              X(0  ) = 0
              X(N+1) = X(N) (m+1) (m+2) X(N), where m is the largest element in X(N)


       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> JSON <?><?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?><?> [0] <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> next <?><?><?><?><?><?><?> <?><?> <?><?> recurse
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?>.

              def next: . + [max + (1, 2)] + .;
              [0] | limit(3; recurse(next)) -->
              [0]
              [0,1,2,0]
              [0,1,2,0,3,4,0,1,2,0]


       <?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> -- <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> (RAM) <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
       :) (<?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?>.  <?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?>)

       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> jq <?><?><?><?> <?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> [0, 1, 2, 0]
       <?><?> <?><?><?><?><?> <?><?><?>.  <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> \f[B]<?><?><?><?><?><?>\f[R]
       <?><?><?><?><?><?><?>.

              def next: [., .[2] + (1,2), .];
              [0] | limit(3; recurse(next)) -->
              [0]
              [[0],1,2,[0]]
              [[[0],1,2,[0]],3,4,[[0],1,2,[0]]]


       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> next<?> <?><?><?><?><?> <?><?><?>
       <?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>.

       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?>.  <?><?><?><?> <?><?><?><?><?>:
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> 2 <?><?><?><?> <?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> 4 <?><?><?>.
       (<?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       null <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> 0 <?><?><?>.  <?><?> <?><?><?> <?><?><?><?> null <?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> 0
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>.)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> .[2] + (1, 2) <?><?> <?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> .. | numbers
       <?><?><?><?><?><?> <?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>:

              [[[0],1,2,[0]],3,4,[[0],1,2,[0]]] | .. | numbers -->
              0 1 2 0 3 4 0 1 2 0


       <?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?>:

              def next: [., .[2] + (1,2), .];
              [0] | nth(30; recurse(next)) | nth(10244; .. | numbers) -->
              2


       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?> 2 <?><?>
       <?><?> <?><?> <?><?><?><?><?><?>.  <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> X = 0<?> Y =
       1 <?> Z = 2 <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> Z <?><?><?>.



   <?><?><?><?><?><?><?> <?><?> HTML (HTML SCRAPING)
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> CBOR
       <https://www.rfc-editor.org/rfc/rfc8949.html#name-examples-of-encoded-cbor-da>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>/<?><?><?><?><?><?><?> CBOR <?><?> jaq
       <?><?><?><?><?> <?><?><?>.  <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> HTML
       <?><?><?> <?><?><?><?> <?> <?><?> <?><?><?><?>
       examples/cbor-examples.xhtml <?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?>:

              <table>
              <tbody>
              <tr>
                <td class="text-left" rowspan="1" colspan="1">25</td>
                <td class="text-left" rowspan="1" colspan="1">0x1819</td>
              </tr>
              <tr>
                <td class="text-left" rowspan="1" colspan="1">100</td>
                <td class="text-left" rowspan="1" colspan="1">0x1864</td>
              </tr>
              </tbody>
              </table>


       <?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> 25 /
       0x1819 <?> 100 / 0x1864 <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> 25 <?><?> CBOR <?><?>
       <?><?><?><?> 0x1819 <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?> jq
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.  <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>:


         o <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <tr> <?><?> .. |
           select(.t? == "tr").


         o <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> .c.


         o <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> .[] <?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           .c?[].



       (<?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?> .c <?><?> .c?
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> XML <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <tr> <td></td> </tr><?> <?><?><?><?>
       <tr> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>: <?><?>
       <?><?><?><?> <?><?><?><?><?> " " <?> <?><?><?><?> <td>.
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> .c
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> .c?
       <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?>.)

       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> HTML
       <?><?><?><?><?><?>:

              "<table>" +
              "<tr>  <td>25</td> <td>0x1819</td> </tr>" +
              "<tr> <td>100</td> <td>0x1864</td> </tr>" +
              "</table>"
              | fromxml | .. | select(.t? == "tr").c | [.[].c?[]] -->
              [ "25", "0x1819"]
              ["100", "0x1864"]


       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> (CLI):

              jaq '.. | select(.t? == "tr").c | [.[].c?[]]' examples/cbor-examples.xhtml


       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?>:

              jaq '.. | select(.t? == "tr").c | [.[].c?[]] | @json "jc(\(.[0]), \(.[1][2:]));"' \
                examples/cbor-examples.xhtml -r


       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> CBOR <?><?> jaq
       <?><?><?><?><?><?><?> <?><?><?><?>.





<?><?><?><?><?><?><?> (AUTHOR)
       Michael Farber



<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       jq(1)

                                                                        JAQ(1)