DOCS-8794: Document sort order for Object #3160
Conversation
| Objects | ||
| ------- | ||
|
|
||
| A comparison of two BSON objects using operators is performed using the following order : |
There was a problem hiding this comment.
Maybe better with the active voice:
The comparison of BSON objects uses the following order:
|
|
||
| A comparison of two BSON objects using operators is performed using the following order : | ||
|
|
||
| #. The key/value pairs are recursively compared in the order of appearance within the BSON object. |
There was a problem hiding this comment.
Active voice:
Recursively compare key/value pairs in the order they appear within the BSON object.
|
|
||
| #. The key/value pairs are recursively compared in the order of appearance within the BSON object. | ||
| #. Compare the :ref:`key field names <document-field-names>`. | ||
| #. If the key field name is equal, compare the value of the field. |
There was a problem hiding this comment.
Pluralize:
If the key field names are equal, compare the field values.
| #. The key/value pairs are recursively compared in the order of appearance within the BSON object. | ||
| #. Compare the :ref:`key field names <document-field-names>`. | ||
| #. If the key field name is equal, compare the value of the field. | ||
| #. If the value of the field is equal, compare the next key/value pair (back to step 1). This is where the length of the object matters, the object with the next non-null element is greater. |
There was a problem hiding this comment.
If the field values are equal, compare the next key/value pair (return to step 1). An object without further pairs is lesser than an object with further pairs.
| @@ -55,6 +55,17 @@ when comparing a field whose value is a single-element array (e.g. ``[ | |||
| ``1`` and ``2``. A comparison of an empty array (e.g. ``[ ]``) treats | |||
| the empty array as less than ``null`` or a missing field. | |||
|
|
|||
| Objects | |||
| ------- | |||
|
|
|||
There was a problem hiding this comment.
This behaviour wasn't changed at 3.4. Not sure what was the first version the behaviour introduced, but just never documented.
| @@ -55,6 +55,17 @@ when comparing a field whose value is a single-element array (e.g. ``[ | |||
| ``1`` and ``2``. A comparison of an empty array (e.g. ``[ ]``) treats | |||
| the empty array as less than ``null`` or a missing field. | |||
|
|
|||
| Objects | |||
| ------- | |||
|
|
|||
|
Merged to master - thanks! |
|
Oh, and back-ported to 3.4 as well. |
* DOCSP-29495 Add Security Bug Form * *
Based on
https://github.com/mongodb/mongo/blob/r3.4.10/src/mongo/bson/bsonobj.cpp#L105
applies to MongoDB v3.4 and v3.6
This change is