From f78dd1c07252ce2dc0a99379c717233279fbb827 Mon Sep 17 00:00:00 2001 From: Angela Date: Wed, 9 Apr 2025 16:43:04 -0400 Subject: [PATCH 1/9] add large integer limit note --- source/includes/large-number-note.rst | 9 +++++++++ source/query/filter.txt | 2 ++ 2 files changed, 11 insertions(+) create mode 100644 source/includes/large-number-note.rst diff --git a/source/includes/large-number-note.rst b/source/includes/large-number-note.rst new file mode 100644 index 000000000..ac040c319 --- /dev/null +++ b/source/includes/large-number-note.rst @@ -0,0 +1,9 @@ +.. note:: Large Integer Limitations + To use a query filter that finds integers over the JavaScript maximum integer size, you must wrap the number value in string characters. + + For example, to find all documents with an integer value of 507550989629521900, use the + following query filter: + + .. code-block:: javascript + + { "number": "507550989629521900" } \ No newline at end of file diff --git a/source/query/filter.txt b/source/query/filter.txt index de41a92b9..23ad409f0 100644 --- a/source/query/filter.txt +++ b/source/query/filter.txt @@ -64,6 +64,8 @@ Set Query Filter :lightbox: :alt: Results of applying a query filter +.. include:: /includes/large-number-note.rst + Examples -------- From a48e0c45ee2c971bd978c8ecd2272717571be885 Mon Sep 17 00:00:00 2001 From: Angela Date: Wed, 9 Apr 2025 16:43:17 -0400 Subject: [PATCH 2/9] fix note syntax --- source/includes/large-number-note.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/source/includes/large-number-note.rst b/source/includes/large-number-note.rst index ac040c319..6f9d1d871 100644 --- a/source/includes/large-number-note.rst +++ b/source/includes/large-number-note.rst @@ -1,4 +1,5 @@ .. note:: Large Integer Limitations + To use a query filter that finds integers over the JavaScript maximum integer size, you must wrap the number value in string characters. For example, to find all documents with an integer value of 507550989629521900, use the From 6077959626b2e7d99b294749eba1e006fd1ac92f Mon Sep 17 00:00:00 2001 From: Angela Date: Wed, 9 Apr 2025 16:51:11 -0400 Subject: [PATCH 3/9] formatting --- source/includes/large-number-note.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/source/includes/large-number-note.rst b/source/includes/large-number-note.rst index 6f9d1d871..8dd0e3c29 100644 --- a/source/includes/large-number-note.rst +++ b/source/includes/large-number-note.rst @@ -1,9 +1,10 @@ .. note:: Large Integer Limitations - - To use a query filter that finds integers over the JavaScript maximum integer size, you must wrap the number value in string characters. - For example, to find all documents with an integer value of 507550989629521900, use the - following query filter: + To use a query filter that finds integers over the JavaScript maximum integer size, + wrap the number value in string characters. + + For example, to find all documents with an ``number`` value of ``507550989629521900``, use + the following query filter: .. code-block:: javascript From b320eb0c1b79846eaffb5a5ec3522c4a07cf8bed Mon Sep 17 00:00:00 2001 From: Angela Date: Wed, 9 Apr 2025 16:54:05 -0400 Subject: [PATCH 4/9] change wording --- source/includes/large-number-note.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/includes/large-number-note.rst b/source/includes/large-number-note.rst index 8dd0e3c29..1e0c94082 100644 --- a/source/includes/large-number-note.rst +++ b/source/includes/large-number-note.rst @@ -1,6 +1,6 @@ .. note:: Large Integer Limitations - To use a query filter that finds integers over the JavaScript maximum integer size, + To run a query that filters for integers over the JavaScript maximum integer size, wrap the number value in string characters. For example, to find all documents with an ``number`` value of ``507550989629521900``, use From 01ba2ab763387cfcae9fb762cc9880cf8a6e1e60 Mon Sep 17 00:00:00 2001 From: Angela Date: Wed, 9 Apr 2025 16:57:14 -0400 Subject: [PATCH 5/9] wording --- source/includes/large-number-note.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/includes/large-number-note.rst b/source/includes/large-number-note.rst index 1e0c94082..58f6cbc21 100644 --- a/source/includes/large-number-note.rst +++ b/source/includes/large-number-note.rst @@ -1,7 +1,7 @@ .. note:: Large Integer Limitations - To run a query that filters for integers over the JavaScript maximum integer size, - wrap the number value in string characters. + To query for integers larger than the JavaScript maximum integer size, + wrap the integer value in string characters. For example, to find all documents with an ``number`` value of ``507550989629521900``, use the following query filter: From eaea07f2d9f0e1c93e1f15c8d0a1ed3619fd8ef8 Mon Sep 17 00:00:00 2001 From: Angela Date: Wed, 9 Apr 2025 16:59:32 -0400 Subject: [PATCH 6/9] grammar --- source/includes/large-number-note.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/includes/large-number-note.rst b/source/includes/large-number-note.rst index 58f6cbc21..4a222e959 100644 --- a/source/includes/large-number-note.rst +++ b/source/includes/large-number-note.rst @@ -3,7 +3,7 @@ To query for integers larger than the JavaScript maximum integer size, wrap the integer value in string characters. - For example, to find all documents with an ``number`` value of ``507550989629521900``, use + For example, to find all documents with a ``number`` value of ``507550989629521900``, use the following query filter: .. code-block:: javascript From 2996c857075add18dff446c72e85821e7f1384e8 Mon Sep 17 00:00:00 2001 From: Angela Date: Wed, 9 Apr 2025 17:32:18 -0400 Subject: [PATCH 7/9] wording --- source/includes/large-number-note.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/includes/large-number-note.rst b/source/includes/large-number-note.rst index 4a222e959..3cce75b69 100644 --- a/source/includes/large-number-note.rst +++ b/source/includes/large-number-note.rst @@ -1,7 +1,7 @@ .. note:: Large Integer Limitations To query for integers larger than the JavaScript maximum integer size, - wrap the integer value in string characters. + wrap the integer in string characters. For example, to find all documents with a ``number`` value of ``507550989629521900``, use the following query filter: From dec6b5a5d30a8e70fce428ad21656720d44e5059 Mon Sep 17 00:00:00 2001 From: Angela Date: Thu, 10 Apr 2025 13:20:37 -0400 Subject: [PATCH 8/9] jp suggestion --- source/includes/large-number-note.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/includes/large-number-note.rst b/source/includes/large-number-note.rst index 3cce75b69..9f0876386 100644 --- a/source/includes/large-number-note.rst +++ b/source/includes/large-number-note.rst @@ -4,7 +4,7 @@ wrap the integer in string characters. For example, to find all documents with a ``number`` value of ``507550989629521900``, use - the following query filter: + this query filter: .. code-block:: javascript From e817b0d66b8c56100d06b897ec352088ca577323 Mon Sep 17 00:00:00 2001 From: Angela Date: Thu, 10 Apr 2025 16:47:51 -0400 Subject: [PATCH 9/9] bb feedback --- source/includes/large-number-note.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/includes/large-number-note.rst b/source/includes/large-number-note.rst index 9f0876386..e0f1db5dd 100644 --- a/source/includes/large-number-note.rst +++ b/source/includes/large-number-note.rst @@ -1,11 +1,11 @@ .. note:: Large Integer Limitations To query for integers larger than the JavaScript maximum integer size, - wrap the integer in string characters. + wrap the integer in string characters and pass the integer to the ``NumberLong()`` constructor. For example, to find all documents with a ``number`` value of ``507550989629521900``, use this query filter: .. code-block:: javascript - { "number": "507550989629521900" } \ No newline at end of file + { "number" : NumberLong("507550989629521900") } \ No newline at end of file