[Docs] Clarify the behvior of first, last, and nth on empty generators

jqlang · Sep 14, 2024 · 7896db5 · 7896db5
1 parent 860af44
commit 7896db5
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/docs/content/manual/v1.7/manual.yml b/docs/content/manual/v1.7/manual.yml
@@ -3017,10 +3017,16 @@ sections:
 
           The `nth(n)` function extracts the nth value of any array at `.`.
 
+          `first` and `nth` output `empty` if the generator has insufficient
+          elements. `last` returns `null` instead.
+
         examples:
           - program: "[range(.)]|[first, last, nth(5)]"
             input: "10"
             output: ["[0,9,5]"]
+          - program: "[range(.)]|[[first], [last], [nth(5)]]"
+            input: "0"
+            output: ["[[],[null],[]]"]
 
       - title: "`reduce`"
         body: |