MongoDB C++ Driver  mongocxx-3.1.0
find.hpp
1 // Copyright 2014 MongoDB Inc.
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
15 #pragma once
16 
17 #include <chrono>
18 #include <cstdint>
19 
20 #include <bsoncxx/document/view_or_value.hpp>
21 #include <bsoncxx/stdx/optional.hpp>
22 #include <bsoncxx/string/view_or_value.hpp>
23 #include <mongocxx/cursor.hpp>
24 #include <mongocxx/hint.hpp>
25 #include <mongocxx/read_preference.hpp>
26 
27 #include <mongocxx/config/prelude.hpp>
28 
29 namespace mongocxx {
30 MONGOCXX_INLINE_NAMESPACE_BEGIN
31 namespace options {
32 
36 class MONGOCXX_API find {
37  public:
47  find& allow_partial_results(bool allow_partial);
48 
56  const stdx::optional<bool>& allow_partial_results() const;
57 
66  find& batch_size(std::int32_t batch_size);
67 
75  const stdx::optional<std::int32_t>& batch_size() const;
76 
86  find& collation(bsoncxx::document::view_or_value collation);
87 
97  const stdx::optional<bsoncxx::document::view_or_value>& collation() const;
98 
108  find& comment(bsoncxx::string::view_or_value comment);
109 
117  const stdx::optional<bsoncxx::string::view_or_value>& comment() const;
118 
127  find& cursor_type(cursor::type cursor_type);
128 
136  const stdx::optional<cursor::type>& cursor_type() const;
137 
149  find& hint(class hint index_hint);
150 
156  const stdx::optional<class hint>& hint() const;
157 
164  find& limit(std::int32_t limit);
165 
171  const stdx::optional<std::int32_t>& limit() const;
172 
182 
190  const stdx::optional<bsoncxx::document::view_or_value>& max() const;
191 
205  find& max_await_time(std::chrono::milliseconds max_await_time);
206 
213  const stdx::optional<std::chrono::milliseconds>& max_await_time() const;
214 
223  find& max_scan(std::int32_t max);
224 
233  const stdx::optional<std::int32_t>& max_scan() const;
234 
243  find& max_time(std::chrono::milliseconds max_time);
244 
252  const stdx::optional<std::chrono::milliseconds>& max_time() const;
253 
263 
271  const stdx::optional<bsoncxx::document::view_or_value>& min() const;
272 
286  find& modifiers(bsoncxx::document::view_or_value modifiers);
287 
298  const stdx::optional<bsoncxx::document::view_or_value>& modifiers() const;
299 
309  find& no_cursor_timeout(bool no_cursor_timeout);
310 
318  const stdx::optional<bool>& no_cursor_timeout() const;
319 
328  find& projection(bsoncxx::document::view_or_value projection);
329 
337  const stdx::optional<bsoncxx::document::view_or_value>& projection() const;
338 
348 
357  const stdx::optional<class read_preference>& read_preference() const;
358 
369  find& return_key(bool return_key);
370 
381  const stdx::optional<bool>& return_key() const;
382 
391  find& show_record_id(bool show_record_id);
392 
402  const stdx::optional<bool>& show_record_id() const;
403 
412  find& skip(std::int32_t skip);
413 
421  const stdx::optional<std::int32_t>& skip() const;
422 
431  find& snapshot(bool snapshot);
432 
440  const stdx::optional<bool>& snapshot() const;
441 
451  find& sort(bsoncxx::document::view_or_value ordering);
452 
460  const stdx::optional<bsoncxx::document::view_or_value>& sort() const;
461 
465  MONGOCXX_PRIVATE find& modifiers_clear();
466 
467  private:
468  stdx::optional<bool> _allow_partial_results;
469  stdx::optional<std::int32_t> _batch_size;
470  stdx::optional<bsoncxx::document::view_or_value> _collation;
471  stdx::optional<bsoncxx::string::view_or_value> _comment;
472  stdx::optional<cursor::type> _cursor_type;
473  stdx::optional<class hint> _hint;
474  stdx::optional<std::int32_t> _limit;
475  stdx::optional<bsoncxx::document::view_or_value> _max;
476  stdx::optional<std::chrono::milliseconds> _max_await_time;
477  stdx::optional<std::int32_t> _max_scan;
478  stdx::optional<std::chrono::milliseconds> _max_time;
479  stdx::optional<bsoncxx::document::view_or_value> _min;
480  stdx::optional<bsoncxx::document::view_or_value> _modifiers;
481  stdx::optional<bool> _no_cursor_timeout;
482  stdx::optional<bsoncxx::document::view_or_value> _projection;
483  stdx::optional<class read_preference> _read_preference;
484  stdx::optional<bool> _return_key;
485  stdx::optional<bool> _show_record_id;
486  stdx::optional<std::int32_t> _skip;
487  stdx::optional<bool> _snapshot;
488  stdx::optional<bsoncxx::document::view_or_value> _ordering;
489 };
490 
491 } // namespace options
492 MONGOCXX_INLINE_NAMESPACE_END
493 } // namespace mongocxx
494 
495 #include <mongocxx/config/postlude.hpp>
Definition: bulk_write.hpp:22
Class representing the optional arguments to a MongoDB query.
Definition: find.hpp:36
Class representing a hint to be passed to a database operation.
Definition: hint.hpp:35
Class representing a preference for how the driver routes read operations to members of a replica set...
Definition: read_preference.hpp:57
Class representing a view-or-value variant type for strings.
Definition: view_or_value.hpp:36