starts-with and ends-before

Author: Chris Cho

source/code-snippets/collation/aggregation-collation.js

@@ -2,10 +2,12 @@
   Retrieve the total number of matching names, grouped by the first_name
   field and sorted by using the German phonebook collation.
 */
+// start aggregation collation
 myColl.aggregate(
   [
     { $group: { "_id": "$first_name", "nameCount": { "$sum": 1 } } },
     { $sort: { "_id": 1 } },
   ],
   { collation: { locale: "de@collation=phonebook" } },
 );
+// end aggregation collation

source/code-snippets/collation/collection-auto-collation.js

@@ -1,2 +1,4 @@
 // Retrieve documents that match "photograph" in the "type" field
-myColl.find({type: "photograph"});
+// start auto collation
+myColl.find({type: "photograph"});
+// end auto collation

source/code-snippets/collation/collection-collation.js

@@ -1,4 +1,6 @@
 // Create the "souvenirs" collection and specify the French Canadian collation
+// start collection collation
 db.createCollection("souvenirs", {
   collation: { locale: "fr_CA" },
-});
+});
+// end collection collation

source/code-snippets/collation/collection-specify-collation.js

@@ -2,7 +2,8 @@
    Retrieve documents that match "photograph" in the "type" field,
    sorted by the Iceland collation and uppercase precedence.
 */
+// start specified collation
  myColl.find({type: "photograph"},
    { collation: { locale: "is", caseFirst: "upper" } }
  );
-
+ // end specified collation

source/code-snippets/collation/findOneAndUpdate-collation.js

@@ -3,8 +3,10 @@
    that precedes "Gunter" when ordered by using the
    German phonebook collation order.
 */
+// start findOneAndUpdate collation
 myColl.findOneAndUpdate(
   { first_name: { $lt: "Gunter" } },
   { $set: { verified: true } },
   { collation: { locale: "de@collation=phonebook" } },
-);
+);
+// end findOneAndUpdate collation

source/code-snippets/collation/index-collation.js

@@ -3,6 +3,8 @@
    locale collation, specifying ascending ordering of the
    "title" field.
 */
+// start index collation
 myColl.createIndex(
   { 'title' : 1 },
   { 'collation' : { 'locale' : 'en_US' } });
+// end index collation

source/code-snippets/collation/query-index-no-collation.js

@@ -2,6 +2,8 @@
    Retrieve documents that match the "year" value "1980"
    in descending order of the value of the "title" field
    that does not use the collation index.
-*/ 
+*/
+// start index no collation
 myColl.find({"year": 1980})
   .sort({"title": -1});
+// end index no collation

source/code-snippets/collation/query-not-indexed-collation.js

@@ -4,5 +4,7 @@
    specifying a collation that does not use the collation
    index.
 */
+// start not indexed collation
 myColl.find({"year": 1980}, {"collation" : {"locale" : "en_US", "strength": 2 }})
-  .sort({"title": -1});
+  .sort({"title": -1});
+// end not indexed collation

source/fundamentals/collations.txt

@@ -120,23 +120,26 @@ collection.
 
 .. literalinclude:: /code-snippets/collation/collection-collation.js
    :language: javascript
-   :lineno-start: 2
+   :start-after: start collection collation
+   :ends-before: end collection collation
 
 Any of the operations that support collations automatically apply the collation
 defined on the collection. The query below searches the ``souvenirs``
 collection and applies the "``fr_CA``" locale collation:
 
 .. literalinclude:: /code-snippets/collation/collection-auto-collation.js
    :language: javascript
-   :lineno-start: 2
+   :start-after: start auto collation
+   :ends-before: end auto collation
 
 You can specify a different collation as a parameter in an operation that
 supports collations. The following query specifies the "``is``" Iceland locale
 and ``caseFirst`` optional parameter with the value "``upper``":
 
 .. literalinclude:: /code-snippets/collation/collection-specify-collation.js
    :language: javascript
-   :lineno-start: 5
+   :start-after: start specified collation
+   :ends-before: end specified collation
 
 Assign a Collation to an Index
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -146,25 +149,27 @@ a collection with a collation set to the "``en_US``" locale.
 
 .. literalinclude:: /code-snippets/collation/index-collation.js
    :language: javascript
-   :lineno-start: 5
+   :start-after: start indexcollation
+   :ends-before: end indexcollation
 
 The following query uses the index we created:
 
 .. literalinclude:: /code-snippets/collation/query-index-collation.js
    :language: javascript
-   :lineno-start: 6
 
 The following queries **do not** use the index that we created. The first
 query does not include a collation and the second contains a different
 strength value than the collation on the index.
 
 .. literalinclude:: /code-snippets/collation/query-not-indexed-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start not indexed collation
+   :ends-before: end not indexed collation
 
 .. literalinclude:: /code-snippets/collation/query-index-no-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start index no collation
+   :ends-before: end index no collation
 
 Collation Query Examples
 ~~~~~~~~~~~~~~~~~~~~~~~~
@@ -203,7 +208,8 @@ which **does not** specify a collation:
 
 .. literalinclude:: /code-snippets/collation/findOneAndUpdate-default-order-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start findOneAndUpdate collation
+   :ends-before: end findOneAndUpdate collation
 
 Since "Gunter" is the first sorted result when using a binary collation, none
 of the documents come lexically before and match the ``$lt`` comparison
@@ -219,7 +225,8 @@ umlauts.
 
 .. literalinclude:: /code-snippets/collation/findOneAndUpdate-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start findOneAndUpdate default order collation
+   :ends-before: end findOneAndUpdate default order collation
 
 Since "Günter" lexically comes before "Gunter" using the
 ``de@collation=phonebook`` collation specified in ``findOneAndUpdate()``,
@@ -250,7 +257,8 @@ lexical order.
 
 .. literalinclude:: /code-snippets/collation/findOneAndDelete-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start findOneAndDelete collation
+   :ends-before: end findOneAndDelete collation
 
 After you run the operation above, the collection contains the following
 documents:
@@ -267,7 +275,8 @@ document it finds that matches the query criteria.
 
 .. literalinclude:: /code-snippets/collation/findOneAndDelete-no-collation.js
    :language: javascript
-   :lineno-start: 6
+   :start-after: start findOneAndDelete no collation
+   :ends-before: end findOneAndDelete no collation
 
 Since all the documents contain lexical values in the ``a`` field that
 match the criteria (greater than the lexical value of "``100``"), the operation
@@ -297,3 +306,5 @@ the German phonebook (``de@collation=phonebook`` locale) order.
 
 .. literalinclude:: /code-snippets/collation/aggregation-collation.js
    :language: javascript
+   :start-after: start aggregation collation
+   :ends-before: end aggregation collation