exception.h

Go to the documentation of this file.

/* Copyright (c) 2008-2022 the MRtrix3 contributors.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * Covered Software is provided under this License on an "as is"
 * basis, without warranty of any kind, either expressed, implied, or
 * statutory, including, without limitation, warranties that the
 * Covered Software is free of defects, merchantable, fit for a
 * particular purpose or non-infringing.
 * See the Mozilla Public License v. 2.0 for more details.
 *
 * For more details, see http://www.mrtrix.org/.
 */
 
#ifndef __mrtrix_exception_h__
#define __mrtrix_exception_h__
 
#include <cerrno>
#include <iostream>
#include <string>
 
#include "types.h"
 
#ifdef MRTRIX_AS_R_LIBRARY
# include "wrap_r.h"
#endif
 
namespace MR
{
  namespace App
  {
    extern int log_level;
    extern int exit_error_code;
  }
 
 
  extern void (*print) (const std::string& msg);
 
 
 
 
  // for internal use only
 
  inline void __print_stderr (const std::string& text)
  {
#ifdef MRTRIX_AS_R_LIBRARY
    REprintf (text.c_str());
#else
    std::cerr << text;
#endif
  }
 
 
  extern void (*report_to_user_func) (const std::string& msg, int type);
 
#define CONSOLE(msg) if (MR::App::log_level >= 1) report_to_user_func (msg, -1)
#define FAIL(msg) if (MR::App::log_level >= 0) report_to_user_func (msg, 0)
#define WARN(msg) if (MR::App::log_level >= 1) report_to_user_func (msg, 1)
#define INFO(msg) if (MR::App::log_level >= 2) report_to_user_func (msg, 2)
#define DEBUG(msg) if (MR::App::log_level >= 3) report_to_user_func (msg, 3)
 
 
 
 
  class Exception { NOMEMALIGN
    public:
      Exception () { }
 
      Exception (const std::string& msg) {
        description.push_back (msg);
      }
      Exception (const Exception& previous_exception, const std::string& msg) :
        description (previous_exception.description) {
        description.push_back (msg);
      }
 
      void display (int log_level = 0) const {
        display_func (*this, log_level);
      }
 
      size_t num () const {
        return description.size();
      }
      const std::string& operator[] (size_t n) const {
        return description[n];
      }
      void push_back (const std::string& s) {
        description.push_back (s);
      }
      void push_back (const Exception& e) {
        for (auto s : e.description)
          push_back (s);
      }
 
      static void (*display_func) (const Exception& E, int log_level);
 
      vector<std::string> description;
  };
 
  class InvalidImageException : public Exception { NOMEMALIGN
    public:
      InvalidImageException (const std::string& msg) : Exception(msg) {}
      InvalidImageException (const Exception& previous_exception, const std::string& msg)
        : Exception(previous_exception, msg) {}
  };
 
 
  class CancelException : public Exception { NOMEMALIGN
    public:
      CancelException () : Exception ("operation cancelled by user") { }
  };
 
  void display_exception_cmdline (const Exception& E, int log_level);
  void cmdline_print_func (const std::string& msg);
  void cmdline_report_to_user_func (const std::string& msg, int type);
 
 
 
  class LogLevelLatch { NOMEMALIGN
    public:
      LogLevelLatch (const int new_level) :
          prev_level (App::log_level)
      {
        App::log_level = new_level;
      }
      ~LogLevelLatch () {
        App::log_level = prev_level;
      }
    private:
      const int prev_level;
  };
 
 
  void check_app_exit_code();
 
 
}
 
#endif