PMDK C++ bindings  1.5.2
This is the C++ bindings documentation for PMDK's libpmemobj.
common.hpp
Go to the documentation of this file.
1 /*
2  * Copyright 2016-2018, Intel Corporation
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * * Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  *
11  * * Redistributions in binary form must reproduce the above copyright
12  * notice, this list of conditions and the following disclaimer in
13  * the documentation and/or other materials provided with the
14  * distribution.
15  *
16  * * Neither the name of the copyright holder nor the names of its
17  * contributors may be used to endorse or promote products derived
18  * from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  */
32 
38 #ifndef LIBPMEMOBJ_CPP_COMMON_HPP
39 #define LIBPMEMOBJ_CPP_COMMON_HPP
40 
42 #include <libpmemobj/tx_base.h>
43 #include <typeinfo>
44 
45 #if defined(__GNUC__) || defined(__clang__)
46 #define POBJ_CPP_DEPRECATED __attribute__((deprecated))
47 #elif defined(_MSC_VER)
48 #define POBJ_CPP_DEPRECATED __declspec(deprecated)
49 #else
50 #define POBJ_CPP_DEPRECATED
51 #endif
52 
53 namespace pmem
54 {
55 
56 namespace obj
57 {
58 template <typename T>
59 class persistent_ptr;
60 }
61 
62 namespace detail
63 {
64 
65 /*
66  * Conditionally add 'count' objects to a transaction.
67  *
68  * Adds count objects starting from `that` to the transaction if '*that' is
69  * within a pmemobj pool and there is an active transaction.
70  * Does nothing otherwise.
71  *
72  * @param[in] that pointer to the first object being added to the transaction.
73  * @param[in] count number of elements to be added to the transaction.
74  */
75 template <typename T>
76 inline void
77 conditional_add_to_tx(const T *that, std::size_t count = 1)
78 {
79  if (count == 0)
80  return;
81 
82  if (pmemobj_tx_stage() != TX_STAGE_WORK)
83  return;
84 
85  /* 'that' is not in any open pool */
86  if (!pmemobj_pool_by_ptr(that))
87  return;
88 
89  if (pmemobj_tx_add_range_direct(that, sizeof(*that) * count))
90  throw transaction_error("Could not add object(s) to the"
91  " transaction.");
92 }
93 
94 /*
95  * Return type number for given type.
96  */
97 template <typename T>
98 uint64_t
99 type_num()
100 {
101  return typeid(T).hash_code();
102 }
103 
104 } /* namespace detail */
105 
106 } /* namespace pmem */
107 
108 #endif /* LIBPMEMOBJ_CPP_COMMON_HPP */
pexceptions.hpp
Custom exceptions.