# Singleton Design Pattern

# Lazy Initialization

This example has been lifted from the Q & A section here:http://stackoverflow.com/a/1008289/3807729 (opens new window)

See this article for a simple design for a lazy evaluated with guaranteed destruction singleton:
Can any one provide me a sample of Singleton in c++? (opens new window)

The classic lazy evaluated and correctly destroyed singleton.

class S
        static S& getInstance()
            static S    instance; // Guaranteed to be destroyed.
                                  // Instantiated on first use.
            return instance;
        S() {};                   // Constructor? (the {} brackets) are needed here.

        // C++ 03
        // ========
        // Dont forget to declare these two. You want to make sure they
        // are unacceptable otherwise you may accidentally get copies of
        // your singleton appearing.
        S(S const&);              // Don't Implement
        void operator=(S const&); // Don't implement

        // C++ 11
        // =======
        // We can use the better technique of deleting the methods
        // we don't want.
        S(S const&)               = delete;
        void operator=(S const&)  = delete;

        // Note: Scott Meyers mentions in his Effective Modern
        //       C++ book, that deleted functions should generally
        //       be public as it results in better error messages
        //       due to the compilers behavior to check accessibility
        //       before deleted status

See this article about when to use a singleton: (not often)
Singleton: How should it be used (opens new window)

See this two article about initialization order and how to cope:
Static variables initialisation order (opens new window)
Finding C++ static initialization order problems (opens new window)

See this article describing lifetimes:
What is the lifetime of a static variable in a C++ function? (opens new window)

See this article that discusses some threading implications to singletons:
Singleton instance declared as static variable of GetInstance method (opens new window)

See this article that explains why double checked locking will not work on C++:
What are all the common undefined behaviours that a C++ programmer should know about? (opens new window)

# Static deinitialization-safe singleton.

There are times with multiple static objects where you need to be able to guarantee that the singleton will not be destroyed until all the static objects that use the singleton no longer need it.

In this case std::shared_ptr can be used to keep the singleton alive for all users even when the static destructors are being called at the end of the program:

class Singleton
    Singleton(Singleton const&) = delete;
    Singleton& operator=(Singleton const&) = delete;

    static std::shared_ptr<Singleton> instance()
        static std::shared_ptr<Singleton> s{new Singleton};
        return s;

    Singleton() {}

NOTE: This example appears as an answer in the Q&A section here. (opens new window)

# Subclasses

class API
    static API& instance();
    virtual ~API() {}
    virtual const char* func1() = 0;
    virtual void func2() = 0;
    API() {}
    API(const API&) = delete;
    API& operator=(const API&) = delete;

class WindowsAPI : public API
    virtual const char* func1()  override { /* Windows code */ }
    virtual void func2() override { /* Windows code */ }    

class LinuxAPI : public API
    virtual const char* func1() override { /* Linux code */ }
    virtual void func2() override { /* Linux code */ }    

API& API::instance() {
    static WindowsAPI instance;
    static LinuxAPI instance;
    return instance;

In this example, a simple compiler switch binds the API class to the appropriate subclass. In this way, API can be accessed without being coupled to platform-specific code.

# Thread-safe Singeton

The C++11 standards guarantees that the initialization of function scope objects are initialized in a synchronized manner. This can be used to implement a thread-safe singleton with lazy initialization (opens new window).

class Foo
    static Foo& instance()
        static Foo inst;
        return inst;
    Foo() {}
    Foo(const Foo&) = delete;
    Foo& operator =(const Foo&) = delete;

# Remarks

A Singleton is designed to ensure a class only has one instance and provides a global point of access to it. If you only require one instance or a convenient global point of access, but not both, consider other options before turning to the singleton.

Global variables can make it harder to reason about code. For example, if one of the calling functions isn't happy with the data it's receiving from a Singleton, you now have to track down what is first giving the singleton bad data in the first place.

Singletons also encourage coupling (opens new window), a term used to describe two components of code that are joined together thus reducing each components own measure of self-containment.

Singletons aren't concurrency friendly. When a class has a global point of access, every thread has the ability to access it which can lead to deadlocks and race conditions.

Lastly, lazy initialization can cause performance issues if initialized at the wrong time. Removing lazy initialization also removes some of the features that do make Singleton's interesting in the first place, such as polymorphism (see Subclasses).

Sources: Game Programming Patterns (opens new window) by Robert Nystrom (opens new window)