Added unique_by function

2 files changed, 16 insertions, 0 deletions

diff --git a/builtin.c b/builtin.c
index 480fb8ae..c54a47c7 100644
--- a/builtin.c
+++ b/builtin.c
@@ -664,6 +664,7 @@ static const char* const jq_builtins[] = {
   "def sort_by(f): _sort_by_impl(map([f]));",
   "def group_by(f): _group_by_impl(map([f]));",
   "def unique: group_by(.) | map(.[0]);",
+  "def unique_by(f): group_by(f) | map(.[0]);",
   "def max_by(f): _max_by_impl(map([f]));",
   "def min_by(f): _min_by_impl(map([f]));",
 #include "libm.h"
diff --git a/docs/content/3.manual/manual.yml b/docs/content/3.manual/manual.yml
index c8fcb5fa..2e2fb366 100644
--- a/docs/content/3.manual/manual.yml
+++ b/docs/content/3.manual/manual.yml
@@ -931,6 +931,21 @@ sections:
             input: '[1,2,5,3,5,3,1,3]'
             output: ['[1,2,3,5]']
 
+      - title: `unique_by`
+        body: |
+          
+          The `unique_by(.foo)` function takes as input an array and produces
+          an array of the same elements, in sorted order, with
+          elqements with a duplicate `.foo` field removed. Think of it as making
+          an array by taking one element out of every group produced by
+          `group_by`.
+        
+        examples:
+          - program: 'unique'
+            input: '[1,2,5,3,5,3,1,3]'
+            output: ['[1,2,3,5]']
+
+
       - title: `reverse`
         body: |