MongoDB C++ Driver mongocxx-3.1.1
Loading...
Searching...
No Matches
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
29namespace mongocxx {
30MONGOCXX_INLINE_NAMESPACE_BEGIN
31namespace options {
32
36class 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
87
97 const stdx::optional<bsoncxx::document::view_or_value>& collation() const;
98
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
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
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
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
492MONGOCXX_INLINE_NAMESPACE_END
493} // namespace mongocxx
494
495#include <mongocxx/config/postlude.hpp>
Class representing a view-or-value variant type for strings.
Definition view_or_value.hpp:36
Class representing a hint to be passed to a database operation.
Definition hint.hpp:35
Class representing the optional arguments to a MongoDB query.
Definition find.hpp:36
find & hint(class hint index_hint)
Sets the index to use for this operation.
const stdx::optional< class read_preference > & read_preference() const
The current read_preference for this operation.
find & sort(bsoncxx::document::view_or_value ordering)
The order in which to return matching documents.
const stdx::optional< bool > & no_cursor_timeout() const
Gets the current no_cursor_timeout setting.
find & return_key(bool return_key)
Sets whether to return the index keys associated with the query results, instead of the actual query ...
const stdx::optional< bsoncxx::document::view_or_value > & collation() const
Retrieves the current collation for this operation.
find & projection(bsoncxx::document::view_or_value projection)
Sets a projection which limits the returned fields for all matching documents.
MONGOCXX_PRIVATE find & modifiers_clear()
Clears the modifiers member.
find & cursor_type(cursor::type cursor_type)
Indicates the type of cursor to use for this query.
find & comment(bsoncxx::string::view_or_value comment)
Attaches a comment to the query.
find & max_await_time(std::chrono::milliseconds max_await_time)
The maximum amount of time for the server to wait on new documents to satisfy a tailable cursor query...
const stdx::optional< bsoncxx::document::view_or_value > & modifiers() const
Gets the current query modifiers.
find & min(bsoncxx::document::view_or_value min)
Gets the current inclusive lower bound for a specific index.
const stdx::optional< bsoncxx::document::view_or_value > & sort() const
Gets the current sort ordering for this query.
const stdx::optional< std::chrono::milliseconds > & max_await_time() const
The maximum amount of time for the server to wait on new documents to satisfy a tailable cursor query...
find & read_preference(class read_preference rp)
Sets the read_preference for this operation.
const stdx::optional< bsoncxx::document::view_or_value > & max() const
Sets the current exclusive upper bound for a specific index.
const stdx::optional< cursor::type > & cursor_type() const
Gets the current cursor type.
find & max_scan(std::int32_t max)
Sets the maximum number of documents or index keys to scan when executing the query.
const stdx::optional< std::chrono::milliseconds > & max_time() const
The current max_time_ms setting.
find & max(bsoncxx::document::view_or_value max)
Gets the current exclusive upper bound for a specific index.
const stdx::optional< bool > & snapshot() const
Gets the current setting for whether snapshot mode is being used.
find & skip(std::int32_t skip)
Sets the number of documents to skip before returning results.
const stdx::optional< bsoncxx::document::view_or_value > & min() const
Sets the current inclusive lower bound for a specific index.
find & allow_partial_results(bool allow_partial)
Sets whether to allow partial results from a mongos if some shards are down (instead of throwing an e...
const stdx::optional< bool > & allow_partial_results() const
Gets the current setting for allowing partial results from mongos.
find & limit(std::int32_t limit)
Sets maximum number of documents to return.
find & snapshot(bool snapshot)
Sets whether snapshot mode should be used.
const stdx::optional< std::int32_t > & batch_size() const
The current batch size setting.
find & collation(bsoncxx::document::view_or_value collation)
Sets the collation for this operation.
const stdx::optional< std::int32_t > & max_scan() const
Gets the current setting for the maximum number of documents to scan when executing the query.
find & max_time(std::chrono::milliseconds max_time)
Sets the maximum amount of time for this operation to run (server-side) in milliseconds.
const stdx::optional< std::int32_t > & skip() const
Gets the current number of documents to skip.
const stdx::optional< bsoncxx::document::view_or_value > & projection() const
Gets the current projection set on this query.
find & modifiers(bsoncxx::document::view_or_value modifiers)
Sets the meta-operators modifying the output or behavior of the query.
const stdx::optional< class hint > & hint() const
Gets the current hint.
find & batch_size(std::int32_t batch_size)
Sets the number of documents to return per batch.
const stdx::optional< std::int32_t > & limit() const
Gets the current limit.
const stdx::optional< bool > & return_key() const
Gets the current setting for returning the index keys associated with the query results,...
find & no_cursor_timeout(bool no_cursor_timeout)
Sets the cursor flag to prevent cursor from timing out server-side due to a period of inactivity.
find & show_record_id(bool show_record_id)
Sets whether to include the record identifier for each document in the query results.
const stdx::optional< bsoncxx::string::view_or_value > & comment() const
Gets the current comment attached to this query.
const stdx::optional< bool > & show_record_id() const
Gets the current setting for whether the record identifier is returned for each document in the query...
Class representing a preference for how the driver routes read operations to members of a replica set...
Definition read_preference.hpp:57
Top level namespace for the MongoDB C++ driver.
Definition bulk_write.hpp:22