====== Návrhové vzory - singleton =======

Nejspíšě nejjednodušším návrhovým vzorem je singleton, třída která může existovat jen v jedné instanci.

Některé knihovny používají singleton pro získání globální konfigurace, kterou nechtějí ukládat do globální proměnné.
[[https://doc.qt.io/qt-5/qcoreapplication.html#instance|QApplication::instace()]]

Vytvoříme třídu //Singleton//, která v našem případě bude skladovat jen jedno číslo a \\
poskytne uživateli metody **getNumber** a **setNumber**.

<code C++>
class Singleton
{
   private:
       int number;
   public:
       int getNumber () { return number; }
       void setNumber (int n) { number = n; }
</code>

//Konstruktor// bude //privátní//, aby nebylo možné vytvářet další instance. 

<code C++>
   private:
      Singleton ();
</code>

Jedinou instanci vytvoří //statická// metoda **getInstance**, která je uvnitř naší třídy a může zavolat privátní konstruktor. \\
Výsledkem metody bude odkaz (reference) na zmíněnou jedinou instanci

<code C++>
public:
    static Singleton & getInstance ();
</code>

Veřejnou statickou metodu můžeme zavolat i mimo naší třídu

<code C++>
int main ()
{
    Singleton & p = Singleton::getInstance ();
    p.setNumber (7);
}
</code>

Vytvořit novou instanci nelze, překladač ohlásí chybu

<code C++>
int main ()
{
    Singleton s; // ERROR: constructor is private
}
</code>

Ukazatel na instanci před uživatelem schováme do privátní proměnné **obj**. \\
Proměnná bude statická, bude tedy existovat pouze jedna, podobně jako globální proměnné. \\
Ke statické proměnné má přístup statická metoda //getInstance//

<code C++>
   private:
       static Singleton * obj;
</code>

Statickou proměnnou musíme ještě definovat a současně ji přiřadíme nulovou počáteční hodnotu. \\
( Definice je podobná implementaci metod. )

<code C++>
Singleton * Singleton::obj = NULL;
</code>

//Statická// metoda //getInstance// je uvniř třídy //Singleton// a tedy může vytvořit novou instanci, \\
zavolat privátní konstruktor a \\
vrátit jako svůj výsledek odkaz na instanci.

<code C++>
Singleton & Singleton::getInstance ()
{
    if (obj == NULL)
        obj = new Singleton ();
    return *obj;
}
</code>

===== Deklarace třídy v hlavičkovém souboru =====

<code C++>
class Singleton
{
private:
    int number;
public:
    int getNumber () { return number; }
    void setNumber (int n) { number = n; }

private:
    Singleton ();

private:
    static Singleton * obj;

public:
    static Singleton & getInstance ();
};
</code>

===== Definice statické proměnné a definice jednotlivých metod =====

<code C++>
Singleton * Singleton::obj = NULL;
</code>

<code C++>
Singleton::Singleton()
{
    number = 0;
}
</code>

<code C++>
Singleton & Singleton::getInstance ()
{
    if (obj == NULL)
        obj = new Singleton ();
    return *obj;
}
</code>

===== Funkce main =====

<code C++>
int main ()
{
    Singleton & p = Singleton::getInstance ();
    p.setNumber (7);
    // Singleton s; // constructor is private
    return 0;
}
</code>