debug_id.h

Go to the documentation of this file.

/*
 * Copyright (c) 2012-2015:  G-CSC, Goethe University Frankfurt
 * Author: Martin Rupp
 * 
 * This file is part of UG4.
 * 
 * UG4 is free software: you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License version 3 (as published by the
 * Free Software Foundation) with the following additional attribution
 * requirements (according to LGPL/GPL v3 §7):
 * 
 * (1) The following notice must be displayed in the Appropriate Legal Notices
 * of covered and combined works: "Based on UG4 (www.ug4.org/license)".
 * 
 * (2) The following notice must be displayed at a prominent place in the
 * terminal output of covered works: "Based on UG4 (www.ug4.org/license)".
 * 
 * (3) The following bibliography is recommended for citation and must be
 * preserved in all covered files:
 * "Reiter, S., Vogel, A., Heppner, I., Rupp, M., and Wittum, G. A massively
 *   parallel geometric multigrid solver on hierarchically distributed grids.
 *   Computing and visualization in science 16, 4 (2013), 151-164"
 * "Vogel, A., Reiter, S., Rupp, M., Nägel, A., and Wittum, G. UG4 -- a novel
 *   flexible software system for simulating pde based models on high performance
 *   computers. Computing and visualization in science 16, 4 (2013), 165-179"
 * 
 * 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 Lesser General Public License for more details.
 */
 
#ifndef __H__UG__COMMON__DEBUG_ID_H
#define __H__UG__COMMON__DEBUG_ID_H
#include <vector>
#include <map>
#include <string>
#include "common/util/crc32.h"
#include <sstream>
 
namespace ug{
 
 
class DebugIDManager;
 
 
 
// DebugID
class DebugID
{
public:
  DebugID(const char *str);
  
  
  DebugID(uint32 hash) { m_hash = hash; }
  inline int get_debug_level() const;
 
  inline bool set_debug_level(int level);
 
  friend class DebugIDManager;
private:
  uint32 m_hash;
};
class DebugID {…};
 
// the list of ug4's standard DebugIDs.
extern DebugID MAIN,
    APP,
    LIB_GRID,
    LIB_GRID_REFINER,
    LIB_DISC,
    LIB_DISC_ASSEMBLE,
    LIB_DISC_D3F,
    LIB_DISC_MULTIGRID,
    LIB_DISC_NEWTON,
    LIB_DISC_LINKER,
    LIB_DISC_TRANSFER,
    LIB_DISC_DISCRETE_FUNCTION,
    LIB_DISC_OUTPUT,
    LIB_DISC_OPERATOR_INVERSE,
    LIB_ALG_LINEAR_OPERATOR,
    LIB_ALG_LINEAR_SOLVER,
    LIB_ALG_VECTOR,
    LIB_ALG_MATRIX,
    LIB_ALG_AMG,
    LIB_PCL;
 
 
class DebugIDManager
{
private:
    inline int get_debug_level(uint32 debugIDhash) const
    {
      std::map<uint32, int>::const_iterator it = m_dbgLevels.find(debugIDhash);
      if(it == m_dbgLevels.end()) return -1;
      else return (*it).second;
    }
    inline int get_debug_level(uint32 debugIDhash) const {…}
    
    inline bool set_debug_level(uint32 debugIDhash, int level)
    {
      std::map<uint32, int>::iterator it = m_dbgLevels.find(debugIDhash);
      if(it == m_dbgLevels.end()) return false;
      else
      {
        (*it).second = level;
        return true;
      }
    }
    inline bool set_debug_level(uint32 debugIDhash, int level) {…}
public:
    static DebugIDManager& instance();
 
    inline bool debug_id_registered(const char *debugIDname) const
    {
      return m_dbgLevels.find(crc32(debugIDname)) != m_dbgLevels.end();
    }
    inline bool debug_id_registered(const char *debugIDname) const {…}
    inline int get_debug_level(const DebugID &debugID) const
    {
      return get_debug_level(debugID.m_hash);
    }
    inline int get_debug_level(const DebugID &debugID) const {…}
    inline int get_debug_level(const char *debugID) const
    {
      return get_debug_level(crc32(debugID));
    }
    inline int get_debug_level(const char *debugID) const {…}
    
    inline DebugID get_debug_id(const char *debugID) const
    {
      return DebugID(crc32(debugID));
    }
    inline DebugID get_debug_id(const char *debugID) const {…}
    
    inline DebugID get_or_create_debug_id(const char *debugID)
    {
      if(debug_id_registered(debugID)==false)
        register_debug_id(debugID);
      return DebugID(crc32(debugID));
    }
    inline DebugID get_or_create_debug_id(const char *debugID) {…}
        
 
    inline bool set_debug_level(DebugID &debugID, int level)
    {
      return set_debug_level(debugID.m_hash, level);
    }
    inline bool set_debug_level(DebugID &debugID, int level) {…}
    bool set_debug_level(const char *debugID, int level);
 
  
    bool set_debug_levels(int lev);
 
    std::string get_registered_debug_IDs() const
    {
      std::stringstream str;
      str << "DebugIDs:\n";
      for(size_t i=0; i<m_dbgLevelIdentifiers.size(); i++)
        str << m_dbgLevelIdentifiers[i] << " : Level " << get_debug_level(m_dbgLevelIdentifiers[i].c_str()) << "\n";
      return str.str();
    }
    std::string get_registered_debug_IDs() const {…}
 
    const std::vector<std::string> &get_registered_debug_IDs_arr() const
    {
      return m_dbgLevelIdentifiers;
    }
    const std::vector<std::string> &get_registered_debug_IDs_arr() const {…}
 
 
 
  bool register_debug_id(const char *debugID);
 
private:
  std::vector<std::string> m_dbgLevelIdentifiers;
  std::map<uint32, int> m_dbgLevels;
};
class DebugIDManager {…};
 
inline DebugIDManager& GetDebugIDManager()
{
  return DebugIDManager::instance();
}
inline DebugIDManager& GetDebugIDManager() {…}
 
inline int DebugID::get_debug_level() const
{
  return GetDebugIDManager().get_debug_level(*this);
}
inline int DebugID::get_debug_level() const {…}
inline bool DebugID::set_debug_level(int level)
{
  return GetDebugIDManager().set_debug_level(*this, level);
}
inline bool DebugID::set_debug_level(int level) {…}
 
// TemporaryDebugLevel
 
#ifdef UG_ENABLE_DEBUG_LOGS
class TemporaryDebugLevel
{
  DebugID &did;
 
  int m_prevDebugLevel;
public:
  TemporaryDebugLevel(DebugID &debugID) : did(debugID)
  {
    m_prevDebugLevel = did.get_debug_level();
  }
 
  TemporaryDebugLevel(DebugID &debugID, int temporaryDebugLevel) : did(debugID)
  {
    m_prevDebugLevel = did.get_debug_level();
    did.set_debug_level(temporaryDebugLevel);
  }
 
  TemporaryDebugLevel(DebugID &debugID, DebugID &debugSrc, int diff=0) : did(debugID)
  {
    m_prevDebugLevel = did.get_debug_level();
    did.set_debug_level(debugSrc.get_debug_level()+diff);
  }
 
  ~TemporaryDebugLevel()
  {
    did.set_debug_level(m_prevDebugLevel);
  }
 
  void set(int temporaryDebugLevel)
  {
    did.set_debug_level(temporaryDebugLevel);
  }
};
#else
class TemporaryDebugLevel
{
 
public:
  TemporaryDebugLevel(DebugID &debugID){}
  TemporaryDebugLevel(DebugID &debugID, int temporaryDebugLevel){}
  TemporaryDebugLevel(DebugID &debugID, DebugID &debugSrc, int diff=0){}
  ~TemporaryDebugLevel(){}
  void set(int temporaryDebugLevel){}
};
#endif
 
// end group ugbase_common
 
} // end namespace ug
#endif  /* __H__UG__COMMON__DEBUG_ID_H */