Jq Usage: Difference between revisions
Jump to navigation
Jump to search
Line 17: | Line 17: | ||
==Object Identifier-Index Filter .key== | ==Object Identifier-Index Filter .key== | ||
.key | |||
The filter expects a map and produces the value associated with the key given as argument of the filter, or null if there is no such object. The value, if exists, can be a primitive, a map or an array. | The filter expects a map and produces the value associated with the key given as argument of the filter, or null if there is no such object. The value, if exists, can be a primitive, a map or an array. | ||
Line 23: | Line 25: | ||
This syntax only works for "identifier-like" keys: keys that are all made of alphanumeric characters and underscore, and which do not start with a digit. | This syntax only works for "identifier-like" keys: keys that are all made of alphanumeric characters and underscore, and which do not start with a digit. | ||
The .key syntax is actually an alias for the more generic syntax: | |||
.["key"] | |||
If the key contains special characters, there's a different syntax <font color=darkgray>TODO</font>. | If the key contains special characters, there's a different syntax <font color=darkgray>TODO</font>. | ||
=Array Filters= | =Array Filters= |
Revision as of 18:38, 1 March 2019
Internal
Command Line Options
-r
Output raw strings, not JSON content.
Universal Filters
Identity Filter .
Map Filters
Object Identifier-Index Filter .key
.key
The filter expects a map and produces the value associated with the key given as argument of the filter, or null if there is no such object. The value, if exists, can be a primitive, a map or an array.
cat example.json | jq '.color'
This syntax only works for "identifier-like" keys: keys that are all made of alphanumeric characters and underscore, and which do not start with a digit.
The .key syntax is actually an alias for the more generic syntax:
.["key"]
If the key contains special characters, there's a different syntax TODO.