oomph_definitions.h

Go to the documentation of this file.

// LIC// ====================================================================
// LIC// This file forms part of oomph-lib, the object-oriented,
// LIC// multi-physics finite-element library, available
// LIC// at http://www.oomph-lib.org.
// LIC//
// LIC// Copyright (C) 2006-2022 Matthias Heil and Andrew Hazel
// LIC//
// LIC// This library is free software; you can redistribute it and/or
// LIC// modify it under the terms of the GNU Lesser General Public
// LIC// License as published by the Free Software Foundation; either
// LIC// version 2.1 of the License, or (at your option) any later version.
// LIC//
// LIC// This library is distributed in the hope that it will be useful,
// LIC// but WITHOUT ANY WARRANTY; without even the implied warranty of
// LIC// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// LIC// Lesser General Public License for more details.
// LIC//
// LIC// You should have received a copy of the GNU Lesser General Public
// LIC// License along with this library; if not, write to the Free Software
// LIC// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
// LIC// 02110-1301  USA.
// LIC//
// LIC// The authors may be contacted at oomph-lib@maths.man.ac.uk.
// LIC//
// LIC//====================================================================
// A header containing the definition of the Oomph run-time
// exception classes and our standard (info) output stream
//(essentially a wrapper to cout but it can be customised,
// e.g. for mpi runs.
 
// Include guard to prevent multiple inclusions of the header
#ifndef OOMPH_DEFINITIONS_HEADER
#define OOMPH_DEFINITIONS_HEADER
 
// Config header generated by autoconfig
#ifdef HAVE_CONFIG_H
#include <oomph-lib-config.h>
#endif
 
// Standard libray headers
#include <stdexcept>
#include <iostream>
#include <string>
#include <vector>
 
 
namespace oomph
{
// Pre-processor magic for error reporting
// Macro that converts argument to string
#define OOMPH_MAKE_STRING(x) #x
 
// Macro wrapper to MAKE_STRING, required because calling
// OOMPH_MAKE_STRING(__LINE__) directly returns __LINE__
// i.e. the conversion of __LINE__ into a number must be performed before
// its conversion into a string
#define OOMPH_TO_STRING(x) OOMPH_MAKE_STRING(x)
 
// Combine the FILE and LINE built-in macros into a string that can
// be used in erorr messages.
#define OOMPH_EXCEPTION_LOCATION __FILE__ ":" OOMPH_TO_STRING(__LINE__)
 
// Get the current function name. All the mess is due to different
// compilers naming the macro we need differently.
#if defined(__GNUC__) || (defined(__MWERKS__) && (__MWERKS__ >= 0x3000)) || \
  (defined(__ICC) && (__ICC >= 600)) || defined(__ghs__)
#define OOMPH_CURRENT_FUNCTION __PRETTY_FUNCTION__
 
#elif defined(__DMC__) && (__DMC__ >= 0x810)
#define OOMPH_CURRENT_FUNCTION __PRETTY_FUNCTION__
 
#elif defined(__FUNCSIG__)
#define OOMPH_CURRENT_FUNCTION __FUNCSIG__
 
#elif (defined(__INTEL_COMPILER) && (__INTEL_COMPILER >= 600)) || \
  (defined(__IBMCPP__) && (__IBMCPP__ >= 500))
#define OOMPH_CURRENT_FUNCTION __FUNCTION__
 
#elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x550)
#define OOMPH_CURRENT_FUNCTION __FUNC__
 
#elif defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901)
#define OOMPH_CURRENT_FUNCTION __func__
 
#else
#define OOMPH_CURRENT_FUNCTION "[Unknown function -- unrecognised compiler]"
 
#endif
 
 
 
 
  //======================================================================
  namespace Global_timings
  {
    extern bool Doc_comprehensive_timings;
 
  }; // namespace Global_timings
 
 
 
  //=======================================================================
  namespace TerminateHelper
  {
    extern void setup();
 
    extern void suppress_exception_error_messages();
 
    extern void spawn_errors_from_uncaught_errors();
 
    extern void clean_up_memory();
 
    extern std::ostream* Error_message_stream_pt;
 
    extern std::stringstream* Exception_stringstream_pt;
 
  } // namespace TerminateHelper
 
 
 
  //======================================================================
  class OomphLibQuietException : public std::runtime_error
  {
  public:
    OomphLibQuietException();
 
    ~OomphLibQuietException() throw() {}
  };
 
 
 
  //======================================================================
  class OomphLibException : public std::runtime_error
  {
  public:
    void disable_error_message()
    {
      // Suppress output of message in destructor...
      Suppress_error_message = true;
 
      // ...and in the big cleanup operation at the end
      TerminateHelper::suppress_exception_error_messages();
    }
 
  protected:
    OomphLibException(const std::string& error_description,
                      const std::string& function_name,
                      const char* location,
                      const std::string& exception_type,
                      std::ostream& exception_stream,
                      const unsigned& output_width,
                      bool list_trace_back);
 
    ~OomphLibException() throw();
 
    std::ostream* Exception_stream_pt;
 
    std::stringstream* Exception_stringstream_pt;
 
    bool Suppress_error_message;
  };
 
  //====================================================================
  //====================================================================
  class OomphLibError : public OomphLibException
  {
    static std::ostream* Stream_pt;
 
    static unsigned Output_width;
 
  public:
    OomphLibError(const std::string& error_description,
                  const std::string& function_name,
                  const char* location)
      : OomphLibException(error_description,
                          function_name,
                          location,
                          "ERROR",
                          *Stream_pt,
                          Output_width,
                          true)
    {
    }
 
    static inline void set_stream_pt(std::ostream* const& stream_pt)
    {
      Stream_pt = stream_pt;
    }
 
    static inline void set_output_width(const unsigned& output_width)
    {
      Output_width = output_width;
    }
  };
 
  //====================================================================
  //====================================================================
  class OomphLibWarning : public OomphLibException
  {
    static std::ostream* Stream_pt;
 
    static unsigned Output_width;
 
  public:
    OomphLibWarning(const std::string& warning_description,
                    const std::string& function_name,
                    const char* location)
      : OomphLibException(warning_description,
                          function_name,
                          location,
                          "WARNING",
                          *Stream_pt,
                          Output_width,
                          false)
    {
    }
 
    static inline void set_stream_pt(std::ostream* const& stream_pt)
    {
      Stream_pt = stream_pt;
    }
 
    static inline void set_output_width(const unsigned& output_width)
    {
      Output_width = output_width;
    }
  };
 
 
 
 
  //=====================================================================
  //=====================================================================
  class Nullstream : public std::ostream
  {
  public:
    Nullstream() : std::ios(0), std::ostream(0) {}
  };
 
 
  //========================================================================
  //========================================================================
  extern Nullstream oomph_nullstream;
 
 
 
 
  //========================================================================
  class OutputModifier
  {
  public:
    OutputModifier() {}
 
    virtual ~OutputModifier() {}
 
    virtual bool operator()(std::ostream& stream)
    {
      return true;
    }
  };
 
 
  //========================================================================
  //========================================================================
  extern OutputModifier default_output_modifier;
 
 
 
 
  //=======================================================================
  //=======================================================================
  namespace Global_output_stream
  {
    extern std::ofstream* Outfile;
 
  } // namespace Global_output_stream
 
 
 
 
  //=======================================================================
  //=======================================================================
  namespace Global_unsigned
  {
    extern unsigned Number;
 
  } // namespace Global_unsigned
 
 
 
 
  //=======================================================================
  //=======================================================================
  namespace Global_string_for_annotation
  {
    extern std::string string(const unsigned& i);
 
    extern std::vector<std::string> String;
  } // namespace Global_string_for_annotation
 
 
 
 
  //=======================================================================
  //=======================================================================
  class OomphInfo
  {
  private:
    std::ostream* Stream_pt;
 
    OutputModifier* Output_modifier_pt;
 
  public:
    OomphInfo()
      : Stream_pt(&std::cout), Output_modifier_pt(&default_output_modifier)
    {
    }
 
    template<class _Tp>
    std::ostream& operator<<(_Tp argument)
    {
      // If the Output_modifer function returns true
      // echo the argument to the stream and return the (vanilla) stream
      if ((*Output_modifier_pt)(*Stream_pt))
      {
        *Stream_pt << argument;
        return (*Stream_pt);
      }
      // Otherwise return the null stream (suppress all future output)
      return oomph_nullstream;
    }
 
    std::ostream*& stream_pt()
    {
      return Stream_pt;
    }
 
    std::ostream& operator<<(std::ostream& (*f)(std::ostream&))
    {
      return f(*Stream_pt);
    }
 
    OutputModifier*& output_modifier_pt()
    {
      return Output_modifier_pt;
    }
  };
 
 
  //========================================================================
  //========================================================================
  extern OomphInfo oomph_info;
 
 
} // namespace oomph
 
#endif