MongoDB C++ Driver mongocxx-3.0.0
Loading...
Searching...
No Matches
hint.hpp
1// Copyright 2015 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 <bsoncxx/document/value.hpp>
18#include <bsoncxx/document/view_or_value.hpp>
19#include <bsoncxx/builder/stream/document.hpp>
20#include <bsoncxx/builder/stream/helpers.hpp>
21#include <bsoncxx/builder/stream/key_context.hpp>
22#include <bsoncxx/stdx/optional.hpp>
23#include <bsoncxx/string/view_or_value.hpp>
24#include <mongocxx/stdx.hpp>
25
26#include <mongocxx/config/prelude.hpp>
27
28namespace mongocxx {
29MONGOCXX_INLINE_NAMESPACE_BEGIN
30
34class MONGOCXX_API hint {
35 public:
46
54
62 friend MONGOCXX_API bool MONGOCXX_CALL operator==(const hint& index_hint, std::string index);
63
64 friend MONGOCXX_API bool MONGOCXX_CALL
65 operator==(const hint& index_hint, bsoncxx::document::view index);
69
76
80 MONGOCXX_INLINE operator bsoncxx::document::value() const;
81
82 private:
83 stdx::optional<bsoncxx::document::view_or_value> _index_doc;
84 stdx::optional<bsoncxx::string::view_or_value> _index_string;
85};
86
94MONGOCXX_API bool MONGOCXX_CALL operator==(std::string index, const hint& index_hint);
95
105MONGOCXX_API bool MONGOCXX_CALL operator!=(const hint& index_hint, std::string index);
106MONGOCXX_API bool MONGOCXX_CALL operator!=(std::string index, const hint& index_index);
110
118MONGOCXX_API bool MONGOCXX_CALL operator==(bsoncxx::document::view index, const hint& index_hint);
119
130MONGOCXX_API bool MONGOCXX_CALL operator!=(const hint& index_hint, bsoncxx::document::view index);
131MONGOCXX_API bool MONGOCXX_CALL operator!=(bsoncxx::document::view index, const hint& index_hint);
135
136MONGOCXX_INLINE hint::operator bsoncxx::document::value() const {
137 return to_document();
138}
139
140MONGOCXX_INLINE_NAMESPACE_END
141} // namespace mongocxx
142
143#include <mongocxx/config/postlude.hpp>
A read-only BSON document that owns its underlying buffer.
Definition value.hpp:33
A read-only, non-owning view of a BSON document.
Definition view.hpp:33
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:34
bool operator==(bsoncxx::document::view index, const hint &index_hint)
Convenience methods to compare for equality against an index document.
friend bool operator==(const hint &index_hint, std::string index)
Compare this hint to a string for (in)-equality.
friend bool operator==(const hint &index_hint, bsoncxx::document::view index)
Compare this hint to a string for (in)-equality.
bool operator==(std::string index, const hint &index_hint)
Convenience methods to compare for equality against an index name.
hint(bsoncxx::document::view_or_value index)
Constructs a new hint.
bsoncxx::document::value to_document() const
Return a bson document representing this hint.
bool operator!=(const hint &index_hint, std::string index)
Convenience methods to compare for inequality against an index name.
bool operator!=(const hint &index_hint, bsoncxx::document::view index)
Convenience methods to compare for equality against an index document.
hint(bsoncxx::string::view_or_value index)
Constructs a new hint.