lifecycle.h

Go to the documentation of this file.

/*
  LIFECYCLE.h  -  interface for registering and triggering lifecycle callbacks 

  Copyright (C)         Lumiera.org
    2008,               Hermann Vosseler <Ichthyostega@web.de>

  This program is free software; you can redistribute it and/or
  modify it under the terms of the GNU General Public License as
  published by the Free Software Foundation; either version 2 of
  the License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

*/

#ifndef LUMIERA_LIFECYCLE_H
#define LUMIERA_LIFECYCLE_H


#ifdef __cplusplus

#include "lib/symbol.hpp"
#include "lib/nocopy.hpp"



namespace lumiera {
  
  using lib::Symbol;
  
  //defined in liblumiera.so
  extern const char * ON_BASIC_INIT;      
  extern const char * ON_GLOBAL_INIT;     
  extern const char * ON_GLOBAL_SHUTDOWN; 
  
  extern const char * ON_EMERGENCY;       

  
  // client code is free to register and use additional lifecycle events
  
  
  
  class LifecycleHook
    : util::NonCopyable
    {
    public:
      typedef void (*Hook)(void);
      
      LifecycleHook (Symbol eventLabel, Hook callbackFun);
      
      static void add (Symbol eventLabel, Hook callbackFun);
      
      static void trigger (Symbol eventLabel);
    };
  
  
  
} // namespace lumiera



#else /* =========== C interface ====================== */


//defined in liblumiera.so
extern const char * lumiera_ON_BASIC_INIT;
extern const char * lumiera_ON_GLOBAL_INIT;
extern const char * lumiera_ON_GLOBAL_SHUTDOWN;


void lumiera_LifecycleHook_add (const char* eventLabel, void callbackFun(void));
void lumiera_Lifecycle_trigger (const char* eventLabel);
  
#endif
#endif