1
0
mirror of https://github.com/stedolan/jq.git synced 2024-05-11 05:55:39 +00:00

I should probably document select and empty :) (#29, #5)

This commit is contained in:
Stephen Dolan
2012-10-22 23:14:34 +01:00
parent 794d29a430
commit 93f80b2726

View File

@@ -390,6 +390,36 @@ sections:
input: '{"abc": 1, "abcd": 2, "Foo": 3}'
output: ['["Foo", "abc", "abcd"]']
- title: `select`
body: |
The function `select(foo)` produces its input unchanged if
`foo` returns true for that input, and produces no output
otherwise.
It's useful for filtering lists: `[1,2,3] | select(. >= 2)`
will give you `[3]`.
examples:
- program: 'select(. >= 2)'
input: '[1,5,3,0,7]'
output: ['[5,3,7]']
- title: `empty`
body: |
`empty` returns no results. None at all. Not even `null`.
It's useful on occasion. You'll know if you need it :)
examples:
- program: '1, empty, 2'
input: 'null'
output: [1,2]
- program: '[1,2,empty,3]'
input: 'null'
output: ['[1,2,3]']
- title: `map(x)`
body: |