Documentation for OpenFLUID 2.2.0
SingletonMacros.hpp
Go to the documentation of this file.
1 /*
2 
3  This file is part of OpenFLUID software
4  Copyright(c) 2007, INRA - Montpellier SupAgro
5 
6 
7  == GNU General Public License Usage ==
8 
9  OpenFLUID is free software: you can redistribute it and/or modify
10  it under the terms of the GNU General Public License as published by
11  the Free Software Foundation, either version 3 of the License, or
12  (at your option) any later version.
13 
14  OpenFLUID is distributed in the hope that it will be useful,
15  but WITHOUT ANY WARRANTY; without even the implied warranty of
16  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17  GNU General Public License for more details.
18 
19  You should have received a copy of the GNU General Public License
20  along with OpenFLUID. If not, see <http://www.gnu.org/licenses/>.
21 
22 
23  == Other Usage ==
24 
25  Other Usage means a use of OpenFLUID that is inconsistent with the GPL
26  license, and requires a written agreement between You and INRA.
27  Licensees for Other Usage of OpenFLUID may use this file in accordance
28  with the terms contained in the written agreement between You and INRA.
29 
30 */
31 
32 /**
33  @file SingletonMacros.hpp
34 
35  @author Jean-Christophe FABRE <jean-christophe.fabre@inra.fr>
36 */
37 
38 
39 #ifndef __OPENFLUID_UTILS_SINGLETONMACROS_HPP__
40 #define __OPENFLUID_UTILS_SINGLETONMACROS_HPP__
41 
42 
43 /**
44  Macro for definition of a dynamic singleton,
45  providing instance() and kill() methods to the class in which it is defined.
46  It must be put in the .hpp file, at the beginning of the class.
47  This implementation is not thread safe.
48 
49  Example of use to design an Example class as a dynamic singleton
50  @snippet misc/singleton.cpp singletonmacros_def
51  @snippet misc/singleton.cpp singletonmacros_init
52 
53  @see OPENFLUID_SINGLETON_INITIALIZATION
54 */
55 #define OPENFLUID_SINGLETON_DEFINITION(T) \
56  private: \
57  T(T const&) = delete; \
58  void operator=(T const&) = delete; \
59  \
60  protected: \
61  static T* mp_Instance; \
62  \
63  public: \
64  static T* instance() \
65  { \
66  if (!mp_Instance) \
67  mp_Instance = new T(); \
68  return mp_Instance; \
69  }\
70  static void kill()\
71  {\
72  if (mp_Instance)\
73  {\
74  delete mp_Instance;\
75  mp_Instance = nullptr;\
76  }\
77  }\
78  static void setInstance(T* Instance)\
79  {\
80  kill();\
81  mp_Instance = Instance;\
82  }
83 
84 
85 // =====================================================================
86 // =====================================================================
87 
88 
89 /**
90  Macro for initialization of a dynamic singleton, must be put in the .cpp file.
91  @see OPENFLUID_SINGLETON_DEFINITION
92 */
93 #define OPENFLUID_SINGLETON_INITIALIZATION(T) \
94  T* T::mp_Instance = nullptr;
95 
96 
97 #endif /* __OPENFLUID_UTILS_SINGLETONMACROS_HPP__ */