MongoDB C++ Driver  mongocxx-3.0.1
cursor.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 <memory>
18 
19 #include <bsoncxx/document/view.hpp>
20 
21 #include <mongocxx/config/prelude.hpp>
22 
23 namespace mongocxx {
24 MONGOCXX_INLINE_NAMESPACE_BEGIN
25 
26 class collection;
27 
35 class MONGOCXX_API cursor {
36  public:
37  enum class type { k_non_tailable, k_tailable, k_tailable_await };
38 
39  class MONGOCXX_API iterator;
40 
44  cursor(cursor&&) noexcept;
45 
49  cursor& operator=(cursor&&) noexcept;
50 
54  ~cursor();
55 
59  iterator begin();
60 
64  iterator end();
65 
66  private:
67  friend class collection;
68  friend class client;
69  friend class database;
70 
71  MONGOCXX_PRIVATE cursor(void* cursor_ptr);
72 
73  class MONGOCXX_PRIVATE impl;
74  std::unique_ptr<impl> _impl;
75 };
76 
80 class MONGOCXX_API cursor::iterator
81  : public std::iterator<std::input_iterator_tag, bsoncxx::document::view> {
82  public:
86  const bsoncxx::document::view& operator*() const;
87 
91  const bsoncxx::document::view* operator->() const;
92 
96  iterator& operator++();
97 
101  void operator++(int);
102 
103  private:
104  friend class cursor;
105 
113  friend MONGOCXX_API bool MONGOCXX_CALL operator==(const iterator&, const iterator&);
114  friend MONGOCXX_API bool MONGOCXX_CALL operator!=(const iterator&, const iterator&);
118 
119  MONGOCXX_PRIVATE explicit iterator(cursor* cursor);
120 
121  cursor* _cursor;
123 };
124 
125 MONGOCXX_INLINE_NAMESPACE_END
126 } // namespace mongocxx
127 
128 #include <mongocxx/config/postlude.hpp>
Definition: bulk_write.hpp:22
A read-only, non-owning view of a BSON document.
Definition: view.hpp:33
Class representing a pointer to the result set of a query on a MongoDB server.
Definition: cursor.hpp:35
Class representing a client connection to MongoDB.
Definition: client.hpp:49
Class representing a MongoDB database.
Definition: database.hpp:43
Class representing an input iterator of documents in a MongoDB cursor result set. ...
Definition: cursor.hpp:80
Class representing server side document groupings within a MongoDB database.
Definition: collection.hpp:74