Singleton.mpp

export module CppUtils.Pattern.Singleton;

import std;

export namespace CppUtils::Pattern
{
	/*
		Cette classe implémente le pattern "Meyers Singleton".
		L'usage de singletons est fortement déconseillé (anti-pattern introduisant un état global).
		En cas de réelle contrainte requierant l'usage d'un singleton, cette implémentation est la solution de référence en C++ moderne.

		Avantages:
		- Lazy initialization: L'instance n'est créée qu'au premier appel de get().
		- Thread-safety: Garanti par le standard C++11 (si plusieurs threads appellent get() simultanément pour la première fois, l'initialisation de la variable statique est thread-safe).
		- Life cycle: Destruction automatique et propre à la fin du programme.
	*/
	template<class T>
	class Singleton final
	{
	public:
		[[nodiscard]] static inline auto get() noexcept -> T&
		{
			static auto instance = T{};
			return instance;
		}

		Singleton() = default;
		Singleton(const Singleton&) = delete;
		Singleton(Singleton&&) = delete;
		auto operator=(const Singleton&) -> Singleton& = delete;
		auto operator=(Singleton&&) -> Singleton& = delete;
		~Singleton() = default;
	};
}