mpd/src/util/Manual.hxx
2023-03-06 14:59:48 +01:00

97 lines
1.8 KiB
C++

// SPDX-License-Identifier: BSD-2-Clause
// author: Max Kellermann <max.kellermann@gmail.com>
#pragma once
#include <cassert>
#include <new>
#include <type_traits>
#include <utility>
/**
* Container for an object that gets constructed and destructed
* manually. The object is constructed in-place, and therefore
* without allocation overhead. It can be constructed and destructed
* repeatedly.
*/
template<class T>
class Manual {
using Storage = std::aligned_storage_t<sizeof(T), alignof(T)>;
Storage storage;
#ifndef NDEBUG
bool initialized = false;
#endif
public:
using value_type = T;
using reference = T &;
using const_reference = const T &;
using pointer = T *;
using const_pointer = const T *;
#ifndef NDEBUG
~Manual() noexcept {
assert(!initialized);
}
#endif
/**
* Cast a value reference to the containing Manual instance.
*/
static constexpr Manual<T> &Cast(reference value) noexcept {
return reinterpret_cast<Manual<T> &>(value);
}
template<typename... Args>
void Construct(Args&&... args) {
assert(!initialized);
::new(&storage) T(std::forward<Args>(args)...);
#ifndef NDEBUG
initialized = true;
#endif
}
void Destruct() noexcept {
assert(initialized);
reference t = Get();
t.T::~T();
#ifndef NDEBUG
initialized = false;
#endif
}
reference Get() noexcept {
assert(initialized);
return *std::launder(reinterpret_cast<pointer>(&storage));
}
const_reference Get() const noexcept {
assert(initialized);
return *std::launder(reinterpret_cast<const_pointer>(&storage));
}
operator reference() noexcept {
return Get();
}
operator const_reference() const noexcept {
return Get();
}
pointer operator->() noexcept {
return &Get();
}
const_pointer operator->() const noexcept {
return &Get();
}
};