Unique acquire from a Semaphore. More...

#include <UniqueAcquire.hpp>

Collaboration diagram for samchon::library::UniqueAcquire:

Public Member Functions
	UniqueAcquire (Semaphore &semaphore, bool lock=true)
	Construct from semaphore. More...

	UniqueAcquire (const UniqueAcquire &obj)=delete
	Prohibited Copy Constructor. More...

	UniqueAcquire (UniqueAcquire &&obj)
	Move Constructor. More...

	~UniqueAcquire ()
	Default Destructor. More...

void	acquire ()
	Acquire admission. More...

void	release ()
	Release an admission. More...

Private Attributes
Semaphore *	semaphore
	Managed semaphore. More...

bool	locked
	Whether the semaphore was acquired by the UniqueLock. More...

Detailed Description

Unique acquire from a Semaphore.

A UniqueAcquire is an object manages a Semaphore with unique ownership in both states.

acquired
released

On construction (or by move-assigning to it), the object acquires a semaphore object, for whose acquiring and releasing operations becomes responsible.

This class guarantees a released status on destruction (even if not called explicitly). Therefore it is especially useful as an object with automatic duration, as it guarantees the semaphore object is properly released in case an exception is thrown.

Referenced comments of std::unique_lock

http://www.cplusplus.com/reference/mutex/unique_lock/

Note

Though, that the UniqueAcquire object does not manage the lifetime of the semaphore object in any way: the duration of the semaphore object shall extend at least until the destruction of the UniqueAcquire that manages it.

The UniqueAcquire is movable, but not copyable.

Library - Critical Section

Author: Jeongho Nam http://samchon.org

Definition at line 39 of file UniqueAcquire.hpp.

Constructor & Destructor Documentation

samchon::library::UniqueAcquire::UniqueAcquire	(	Semaphore &	semaphore,
		bool	lock = `true`
	)

inline

Construct from semaphore.

Parameters

semaphore	Semaphore to manage
lock	Whether to lock directly or not

Definition at line 62 of file UniqueAcquire.hpp.

References acquire(), and semaphore.

Here is the call graph for this function:

samchon::library::UniqueAcquire::UniqueAcquire ( const UniqueAcquire & obj )

delete

Prohibited Copy Constructor.

UniqueAcquire can't be copied. Use pointer, reference instead.

If what you want is UniqueAcquire(s) references each other and unlock when all related UniqueAcquire objects are destructed, SharedAcquire is the best way.

Parameters