lifecycle.h

Go to the documentation of this file.

/*
  LIFECYCLE.h  -  interface for registering and triggering lifecycle callbacks
 
   Copyright (C)
     2008,            Hermann Vosseler <Ichthyostega@web.de>
 
 **Lumiera** 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. See the file COPYING for further details.
 
*/
 
#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 CStr ON_BASIC_INIT;      
  extern CStr ON_GLOBAL_INIT;     
  extern CStr ON_GLOBAL_SHUTDOWN; 
  
  extern CStr 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