PMDK C++ bindings  1.10
This is the C++ bindings documentation for PMDK's libpmemobj.
Classes | Public Member Functions | List of all members
pmem::obj::transaction::automatic Class Reference

C++ automatic scope transaction class. More...

#include <libpmemobj++/transaction.hpp>

Classes

class  uncaught_exception_counter
 Internal class for counting active exceptions. More...
 

Public Member Functions

template<typename... L>
 automatic (obj::pool_base &pop, L &... locks)
 RAII constructor with pmem resident locks. More...
 
 ~automatic () noexcept(false)
 Destructor. More...
 
 automatic (const automatic &p)=delete
 Deleted copy constructor.
 
 automatic (const automatic &&p)=delete
 Deleted move constructor.
 
automaticoperator= (const automatic &p)=delete
 Deleted assignment operator.
 
automaticoperator= (automatic &&p)=delete
 Deleted move assignment operator.
 

Detailed Description

C++ automatic scope transaction class.

This class is one of pmemobj transaction handlers. All operations between creating and destroying the transaction object are treated as performed in a transaction block and can be rolled back. If you have a C++17 compliant compiler, the automatic transaction will commit and abort automatically depending on the context of object destruction.

The locks are held for the entire duration of the transaction. They are released at the end of the scope, so within the catch block, they are already unlocked. If the cleanup action requires access to data within a critical section, the locks have to be manually acquired once again.

The typical usage example would be:

using namespace pmem::obj;
int
automatic_tx_example()
{
// pool root structure
struct root {
mutex pmutex;
shared_mutex shared_pmutex;
p<int> count;
persistent_ptr<root> another_root;
};
// create a pmemobj pool
auto pop = pool<root>::create("poolfile", "layout", PMEMOBJ_MIN_POOL);
auto proot = pop.root();
try {
transaction::automatic tx(pop, proot->pmutex,
proot->shared_pmutex);
// atomically allocate objects
proot->another_root = make_persistent<root>();
// atomically modify objects
proot->count++;
// manual transaction commit is no longer necessary
// an internal transaction error occurred, tx aborted
// reacquire locks if necessary
} catch (...) {
// some other exception thrown, tx aborted
// reacquire locks if necessary
}
// In complex cases with library calls, remember to check the status of
// the previous transaction.
return transaction::error();
}

Constructor & Destructor Documentation

◆ automatic()

template<typename... L>
pmem::obj::transaction::automatic::automatic ( obj::pool_base pop,
L &...  locks 
)
inline

RAII constructor with pmem resident locks.

Start pmemobj transaction and add list of locks to new transaction. The list of locks may be empty.

This class is only available if the __cpp_lib_uncaught_exceptions feature macro is defined. This is a C++17 feature.

Parameters
[in,out]poppool object.
[in,out]lockslocks of obj::mutex or obj::shared_mutex type.
Exceptions
pmem::transaction_errorwhen pmemobj_tx_begin function or locks adding failed.

◆ ~automatic()

pmem::obj::transaction::automatic::~automatic ( )
inlinenoexcept

Destructor.

End pmemobj transaction. Depending on the context of object destruction, the transaction will automatically be either committed or aborted.

Exceptions
pmem::transaction_errorif the transaction got aborted without an active exception.

The documentation for this class was generated from the following file:
pmem::obj::mutex
Persistent memory resident mutex implementation.
Definition: mutex.hpp:31
pmem::obj::pool::create
static pool< T > create(const std::string &path, const std::string &layout, std::size_t size=PMEMOBJ_MIN_POOL, mode_t mode=DEFAULT_MODE)
Creates a new transactional object store pool.
Definition: pool.hpp:674
pmem::transaction_error
Custom transaction error class.
Definition: pexceptions.hpp:63
pmem::obj::p
Resides on pmem class.
Definition: p.hpp:35
pmem::obj::pool::root
persistent_ptr< T > root()
Retrieves pool's root object.
Definition: pool.hpp:624
pool.hpp
C++ pmemobj pool.
make_persistent.hpp
Persistent_ptr transactional allocation functions for objects.
pmem::obj
Main libpmemobj namespace.
Definition: allocation_flag.hpp:18
transaction.hpp
C++ pmemobj transactions.
pmem::obj::transaction::automatic
C++ automatic scope transaction class.
Definition: transaction.hpp:178
pmem::obj::persistent_ptr
Persistent pointer class.
Definition: persistent_ptr.hpp:183
shared_mutex.hpp
Pmem-resident shared mutex.
pext.hpp
Convenience extensions for the resides on pmem property template.
persistent_ptr.hpp
Persistent smart pointer.
pmem::obj::shared_mutex
Persistent memory resident shared_mutex implementation.
Definition: shared_mutex.hpp:30
mutex.hpp
Pmem-resident mutex.