libcruft-util/singleton.hpp

70 lines
1.9 KiB
C++
Raw Normal View History

2018-03-22 15:06:48 +11:00
/*
2018-08-04 15:14:06 +10:00
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
2018-03-22 15:06:48 +11:00
*
* Copyright 2018 Danny Robson <danny@nerdcruft.net>
*/
#ifndef CRUFT_UTIL_SINGLETON_HPP
#define CRUFT_UTIL_SINGLETON_HPP
#include "debug.hpp"
#include <memory>
namespace util {
2018-03-27 16:15:54 +11:00
/// statically stores a single value of the named type.
///
/// this does not prevent the instantiation of the named type, but
/// instead defines a method to refer to a single instance across an
/// application.
2018-03-22 15:06:48 +11:00
template <typename SelfT>
class singleton {
private:
singleton () = default;
static SelfT *instance;
public:
2018-03-27 16:15:54 +11:00
/// instantiates the one blessed value of this type.
///
/// `instantiate` must be called once and once only before any calls
/// to `get`. it is not threadsafe. there are some (unsafe)
/// assertions against multiple instantiations but they may not be
/// relied upon.
///
/// returns a unique_ptr to the value which the caller must store
/// until it will never be needed again.
2018-03-22 15:06:48 +11:00
template <typename ...Args>
static std::unique_ptr<SelfT>
instantiate [[nodiscard]] (Args &&...args)
{
CHECK (!instance);
auto cookie =std::make_unique<SelfT> (std::forward<Args> (args)...);
instance = cookie.get ();
return cookie;
}
2018-03-27 16:15:54 +11:00
/// returns a reference to sole instantiated value
///
/// `instantiate` must have already been called before `get` is called.
2018-03-22 15:06:48 +11:00
static SelfT&
get (void)
{
2018-03-27 16:15:54 +11:00
CHECK (instance);
2018-03-22 15:06:48 +11:00
return *instance;
}
};
};
template <typename SelfT>
SelfT*
util::singleton<SelfT>::instance;
#endif