DOCSP-51974 $elemMatch in $match Example (#14270)

Author: kennethdyer

content/manual/upcoming/source/reference/operator/aggregation/match.txt

@@ -185,6 +185,42 @@ Examples
 
          { "_id" : null, "count" : 5 }
 
+      Match Array Elements
+      ~~~~~~~~~~~~~~~~~~~~
+
+      To filter documents from a collection or previous
+      aggregation stage based on elements in an array, use the
+      :query:`$elemMatch` operator in the query predicate of the
+      ``$match`` stage:
+
+      .. io-code-block::
+
+         .. input::
+            :language: javascript
+            :emphasize-lines: 9-11
+
+            db.aggregate( [ 
+               { 
+                  $documents: [ 
+                     { student_id: 1, scores: [ 0.75, 0.65, 0.73 ] },
+                     { student_id: 2, scores: [ 0.9, 0.88, 0.98 ] },
+                     { student_id: 3, scores: [ 0.9, 0.84, 0.93 ] }
+                  ]
+               }, {
+                  $match: {
+                     scores: { $elemMatch: { $gte: 0.9 } } 
+                  } 
+               } 
+            ] )
+
+         .. output::
+            :language: javascript
+
+            [
+               { student_id: 2, scores: [ 0.9, 0.88, 0.98 ] },
+               { student_id: 3, scores: [ 0.9, 0.84, 0.93 ] }
+            ]
+
    .. tab::
       :tabid: csharp