libcruft-util/singleton.hpp

/*
 * 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/.
 *
 * Copyright 2018 Danny Robson <danny@nerdcruft.net>
 */

#ifndef CRUFT_UTIL_SINGLETON_HPP
#define CRUFT_UTIL_SINGLETON_HPP

#include "debug.hpp"

#include <memory>


namespace cruft {
    /// 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.
    template <typename SelfT>
    class singleton {
    private:
        singleton () = default;

        static SelfT *instance;

    public:
        /// 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.
        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;
        }


        /// returns a reference to sole instantiated value
        ///
        /// `instantiate` must have already been called before `get` is called.
        static SelfT&
        get (void)
        {
            CHECK (instance);
            return *instance;
        }
    };
};


template <typename SelfT>
SelfT*
cruft::singleton<SelfT>::instance;

#endif