Call on release allows the user to pass a function to be called at destruction of this instance. More...

#include <basic_algos.hpp>

Collaboration diagram for jau::call_on_release< UnaryFunction >:

Public Member Functions
	call_on_release (const call_on_release &)=delete

	call_on_release (UnaryFunction release_func) noexcept

	~call_on_release () noexcept

bool	is_released () const noexcept
	Query whethr the resource has been orderly released. More...

call_on_release &	operator= (const call_on_release &) volatile=delete

call_on_release &	operator= (const call_on_release &)=delete

void	set_released () noexcept
	Mark the resource being orderly released, `release_func()` will not be called and use after free avoided. More...

Detailed Description

template<class UnaryFunction>
class jau::call_on_release< UnaryFunction >

Call on release allows the user to pass a function to be called at destruction of this instance.

One goal was to provide a thread exit cleanup facility, setting a 'is_running' flag to false when the thread exists normally or abnormally.

  jau::relaxed_atomic_bool is_running = true;

  void some_thread_func() {
      thread_local jau::call_on_release thread_cleanup([&]() {
          is_running = false;
      });
      ...
      do some work here, which might get cancelled
      ..
      thread_cleanup.set_released(); // mark orderly release
  }

Template Parameters

UnaryFunction user provided function to be called @ dtor

See also: jau::service_runner

Definition at line 65 of file basic_algos.hpp.