MongoDB C++ Driver  mongocxx-3.7.0
oid.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 <array>
18 #include <ctime>
19 #include <string>
20 
21 #include <bsoncxx/stdx/string_view.hpp>
22 
23 #include <bsoncxx/config/prelude.hpp>
24 
25 namespace bsoncxx {
26 BSONCXX_INLINE_NAMESPACE_BEGIN
27 
38 class BSONCXX_API oid {
39  public:
40  static constexpr std::size_t k_oid_length = 12;
41 
45  oid();
46 
57  explicit oid(const char* bytes, std::size_t len);
58 
68  explicit oid(const bsoncxx::stdx::string_view& str);
69 
75  std::string to_string() const;
76 
82  static std::size_t size() {
83  return k_oid_length;
84  }
85 
93  friend BSONCXX_API bool BSONCXX_CALL operator<(const oid& lhs, const oid& rhs);
94  friend BSONCXX_API bool BSONCXX_CALL operator>(const oid& lhs, const oid& rhs);
95  friend BSONCXX_API bool BSONCXX_CALL operator<=(const oid& lhs, const oid& rhs);
96  friend BSONCXX_API bool BSONCXX_CALL operator>=(const oid& lhs, const oid& rhs);
97  friend BSONCXX_API bool BSONCXX_CALL operator==(const oid& lhs, const oid& rhs);
98  friend BSONCXX_API bool BSONCXX_CALL operator!=(const oid& lhs, const oid& rhs);
102 
108  std::time_t get_time_t() const;
109 
115  const char* bytes() const;
116 
117  private:
118  friend BSONCXX_PRIVATE int oid_compare(const oid& lhs, const oid& rhs);
119 
120  std::array<char, k_oid_length> _bytes;
121 };
122 
123 BSONCXX_INLINE_NAMESPACE_END
124 } // namespace bsoncxx
125 
126 #include <bsoncxx/config/postlude.hpp>
bsoncxx
Top level namespace for MongoDB C++ BSON functionality.
Definition: element.hpp:24
bsoncxx::oid
Represents a MongoDB ObjectId.
Definition: oid.hpp:38
bsoncxx::to_string
std::string to_string(type rhs)
Returns a stringification of the given type.
bsoncxx::oid::size
static std::size_t size()
Returns the number of bytes in this ObjectId.
Definition: oid.hpp:82