mirror of
				https://github.com/stedolan/jq.git
				synced 2024-05-11 05:55:39 +00:00 
			
		
		
		
	Document getpath/setpath
This commit is contained in:
		@@ -770,6 +770,36 @@ sections:
 | 
			
		||||
            input: '["foo", "bar", "baz"]'
 | 
			
		||||
            output: ['["foo"]']
 | 
			
		||||
 | 
			
		||||
      - title: "`gepath(PATHS)`"
 | 
			
		||||
        body: |
 | 
			
		||||
 | 
			
		||||
          The builtin function `getpath` outputs the values in `.` found
 | 
			
		||||
          at each path in `PATHS`.
 | 
			
		||||
 | 
			
		||||
        examples:
 | 
			
		||||
          - program: 'getpath(["a","b"])'
 | 
			
		||||
            input: 'null'
 | 
			
		||||
            output: ['null']
 | 
			
		||||
          - program: '[getpath(["a","b"], ["a","c"])]'
 | 
			
		||||
            input: '{"a":{"b":0, "c":1}}'
 | 
			
		||||
            output: ['[0, 1]']
 | 
			
		||||
 | 
			
		||||
      - title: "`sepath(PATHS; VALUE)`"
 | 
			
		||||
        body: |
 | 
			
		||||
 | 
			
		||||
          The builtin function `setpath` sets the `PATHS` in `.` to `VALUE`.
 | 
			
		||||
 | 
			
		||||
        examples:
 | 
			
		||||
          - program: 'setpath(["a","b"]; 1)'
 | 
			
		||||
            input: 'null'
 | 
			
		||||
            output: ['{"a": {"b": 1}}']
 | 
			
		||||
          - program: 'setpath(["a","b"]; 1)'
 | 
			
		||||
            input: '{"a":{"b":0}}'
 | 
			
		||||
            output: ['{"a": {"b": 1}}']
 | 
			
		||||
          - program: 'setpath([0,"a"]; 1)'
 | 
			
		||||
            input: 'null'
 | 
			
		||||
            output: ['[{"a":1}]']
 | 
			
		||||
 | 
			
		||||
      - title: "`to_entries`, `from_entries`, `with_entries`"
 | 
			
		||||
        body: |
 | 
			
		||||
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user