dispenso::OnceFunction Class Reference

#include <once_function.h>

Public Member Functions
	OnceFunction ()
template<typename F >
	OnceFunction (F &&f)
	OnceFunction (const OnceFunction &other)=delete
	OnceFunction (OnceFunction &&other) noexcept
void	cleanupNotRun ()

Detailed Description

A class fullfilling the void() signature, and operator() must be called exactly once for valid OnceFunctions. This class can be much more efficient than std::function for type erasing functors without too much state (currently 56 bytes inline buffer).

Note

The wrapped type-erased functor in OnceFunction is not deleted upon destruction, but rather when operator() is called. It is the user's responsibility to ensure that operator() is called.

Definition at line 54 of file once_function.h.

Constructor & Destructor Documentation

OnceFunction() [1/3]

dispenso::OnceFunction::OnceFunction ( )

inline

Construct a OnceFunction with invalid state.

Definition at line 59 of file once_function.h.

OnceFunction() [2/3]

template<typename F >

dispenso::OnceFunction::OnceFunction ( F && f )

inline

Construct a OnceFunction with a valid functor.

Parameters

f	A functor with signature void(). Ideally this should be a concrete functor (e.g. from lambda), though it will work with e.g. std::function. The downside in the latter case is extra overhead for double type erasure.

Definition at line 70 of file once_function.h.

OnceFunction() [3/3]

dispenso::OnceFunction::OnceFunction ( OnceFunction && other )

inlinenoexcept

Move constructor. Copies the full 64-byte object (one cache line), except for inline functors that are not trivially copyable, which are move-constructed into place.

Definition at line 78 of file once_function.h.

Member Function Documentation

cleanupNotRun()

void dispenso::OnceFunction::cleanupNotRun ( )

inline

Destroy the type-erased functor and release its resources without invoking it. Use this when a OnceFunction will not be called but its resources must still be freed. Like operator(), this must be called at most once, and the OnceFunction must not be used after.

Definition at line 99 of file once_function.h.

---

The documentation for this class was generated from the following file:

• /home/runner/work/dispenso/dispenso/dispenso/once_function.h