Exception.h

Go to the documentation of this file.

// --------------------------------------------------------------------------
//                   OpenMS -- Open-Source Mass Spectrometry
// --------------------------------------------------------------------------
// Copyright The OpenMS Team -- Eberhard Karls University Tuebingen,
// ETH Zurich, and Freie Universitaet Berlin 2002-2018.
//
// This software is released under a three-clause BSD license:
//  * Redistributions of source code must retain the above copyright
//    notice, this list of conditions and the following disclaimer.
//  * Redistributions in binary form must reproduce the above copyright
//    notice, this list of conditions and the following disclaimer in the
//    documentation and/or other materials provided with the distribution.
//  * Neither the name of any author or any participating institution
//    may be used to endorse or promote products derived from this software
//    without specific prior written permission.
// For a full list of authors, refer to the file AUTHORS.
// --------------------------------------------------------------------------
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL ANY OF THE AUTHORS OR THE CONTRIBUTING
// INSTITUTIONS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
// EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
// OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
// WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
// OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
// ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//
// --------------------------------------------------------------------------
// $Maintainer: Timo Sachsenberg$
// $Authors: Marc Sturm $
// --------------------------------------------------------------------------

#pragma once

#include <OpenMS/OpenMSConfig.h>
#include <OpenMS/CONCEPT/Types.h>

#include <iosfwd>
#include <new>
#include <string>

namespace OpenMS
{

  namespace Exception
  {

    class OPENMS_DLLAPI BaseException :
      public std::exception
    {
public:


      BaseException() noexcept;

      BaseException(const char* file, int line, const char* function) noexcept;

      BaseException(const char* file, int line, const char* function, const std::string& name, const std::string& message) noexcept;

      BaseException(const BaseException& exception) noexcept;

      ~BaseException() noexcept override;


      const char* getName() const noexcept;

      const char* what() const noexcept override;

      int getLine() const noexcept;

      const char* getFile() const noexcept;

      const char* getFunction() const noexcept;

      const char* getMessage() const noexcept;

      void setMessage(const std::string& message) noexcept;


protected:

      const char* file_;

      int line_;

      const char* function_;

      std::string name_;

      std::string what_;
    };

    class OPENMS_DLLAPI Precondition :
      public BaseException
    {
public:
      Precondition(const char* file, int line, const char* function, const std::string& condition)  noexcept;
    };

    class OPENMS_DLLAPI Postcondition :
      public BaseException
    {
public:
      Postcondition(const char* file, int line, const char* function, const std::string& condition) noexcept;
    };

    class OPENMS_DLLAPI MissingInformation :
      public BaseException
    {
public:
      MissingInformation(const char* file, int line, const char* function, const std::string& error_message) noexcept;
    };


    class OPENMS_DLLAPI IndexUnderflow :
      public BaseException
    {
public:
      IndexUnderflow(const char* file, int line, const char* function, SignedSize index = 0, Size size = 0) noexcept;
    };

    class OPENMS_DLLAPI SizeUnderflow :
      public BaseException
    {
public:
      SizeUnderflow(const char* file, int line, const char* function, Size size = 0) noexcept;
    };

    class OPENMS_DLLAPI IndexOverflow :
      public BaseException
    {
public:
      IndexOverflow(const char* file, int line, const char* function, SignedSize index = 0, Size size = 0) noexcept;
    };

    class OPENMS_DLLAPI FailedAPICall :
      public BaseException
    {
public:
      FailedAPICall(const char* file, int line, const char* function, const std::string& message) noexcept;
    };

    class OPENMS_DLLAPI InvalidRange :
      public BaseException
    {
public:
      InvalidRange(const char* file, int line, const char* function) noexcept;
    };


    class OPENMS_DLLAPI InvalidSize :
      public BaseException
    {
public:
      InvalidSize(const char* file, int line, const char* function, Size size = 0) noexcept;
    };


    class OPENMS_DLLAPI OutOfRange :
      public BaseException
    {
public:
      OutOfRange(const char* file, int line, const char* function) noexcept;
    };

    class OPENMS_DLLAPI InvalidValue :
      public BaseException
    {
public:
      InvalidValue(const char* file, int line, const char* function, const std::string& message, const std::string& value) noexcept;
    };

    class OPENMS_DLLAPI InvalidParameter :
      public BaseException
    {
public:
      InvalidParameter(const char* file, int line, const char* function, const std::string& message) noexcept;
    };

    class OPENMS_DLLAPI ConversionError :
      public BaseException
    {
public:
      ConversionError(const char* file, int line, const char* function, const std::string& error) noexcept;
    };

    class OPENMS_DLLAPI IllegalSelfOperation :
      public BaseException
    {
public:
      IllegalSelfOperation(const char* file, int line, const char* function) noexcept;
    };

    class OPENMS_DLLAPI NullPointer :
      public BaseException
    {
public:
      NullPointer(const char* file, int line, const char* function) noexcept;
    };

    class OPENMS_DLLAPI InvalidIterator :
      public BaseException
    {
public:
      InvalidIterator(const char* file, int line, const char* function) noexcept;
    };

    class OPENMS_DLLAPI IncompatibleIterators :
      public BaseException
    {
public:
      IncompatibleIterators(const char* file, int line, const char* function) noexcept;
    };

    class OPENMS_DLLAPI NotImplemented :
      public BaseException
    {
public:
      NotImplemented(const char* file, int line, const char* function) noexcept;
    };

    class OPENMS_DLLAPI IllegalTreeOperation :
      public BaseException
    {
public:
      IllegalTreeOperation(const char* file, int line, const char* function) noexcept;
    };

#ifdef _MSC_VER // disable some seqan warnings that distract from ours
#   pragma warning( push ) // save warning state
#   pragma warning( disable : 4275 )
#endif
    class OPENMS_DLLAPI OutOfMemory :
      public BaseException, public std::bad_alloc
    {
public:
      OutOfMemory(const char* file, int line, const char* function, Size size = 0) noexcept;
    };
#ifdef _MSC_VER
#   pragma warning( pop ) // restore old warning state
#endif

    class OPENMS_DLLAPI BufferOverflow :
      public BaseException
    {
public:
      BufferOverflow(const char* file, int line, const char* function) noexcept;
    };

    class OPENMS_DLLAPI DivisionByZero :
      public BaseException
    {
public:
      DivisionByZero(const char* file, int line, const char* function) noexcept;
    };

    class OPENMS_DLLAPI OutOfGrid :
      public BaseException
    {
public:
      OutOfGrid(const char* file, int line, const char* function) noexcept;
    };

    class OPENMS_DLLAPI FileNotFound :
      public BaseException
    {
public:
      FileNotFound(const char* file, int line, const char* function, const std::string& filename) noexcept;
    };

    class OPENMS_DLLAPI FileNotReadable :
      public BaseException
    {
public:
      FileNotReadable(const char* file, int line, const char* function, const std::string& filename) noexcept;
    };

    class OPENMS_DLLAPI FileNotWritable :
      public BaseException
    {
public:
      FileNotWritable(const char* file, int line, const char* function, const std::string& filename) noexcept;
    };

    class OPENMS_DLLAPI FileNameTooLong :
      public BaseException
    {
    public:
      FileNameTooLong(const char* file, int line, const char* function, const std::string& filename, int max_length) noexcept;
    };

    class OPENMS_DLLAPI IOException :
      public BaseException
    {
public:
      IOException(const char* file, int line, const char* function, const std::string& filename) noexcept;
    };

    class OPENMS_DLLAPI FileEmpty :
      public BaseException
    {
public:
      FileEmpty(const char* file, int line, const char* function, const std::string& filename) noexcept;
    };

    class OPENMS_DLLAPI IllegalPosition :
      public BaseException
    {
public:
      IllegalPosition(const char* file, int line, const char* function, float x, float y, float z) noexcept;
    };

    class OPENMS_DLLAPI ParseError :
      public BaseException
    {
public:
      ParseError(const char* file, int line, const char* function, const std::string& expression, const std::string& message) noexcept;
    };

    class OPENMS_DLLAPI UnableToCreateFile :
      public BaseException
    {
public:
      UnableToCreateFile(const char* file, int line, const char* function, const std::string& filename, const std::string& message = "") noexcept;
    };

    class OPENMS_DLLAPI IllegalArgument :
      public BaseException
    {
public:
      IllegalArgument(const char* file, int line, const char* function, const std::string& error_message) noexcept;
    };

    class OPENMS_DLLAPI ElementNotFound :
      public BaseException
    {
public:
      ElementNotFound(const char* file, int line, const char* function, const std::string& element) noexcept;
    };

    class OPENMS_DLLAPI UnableToFit :
      public BaseException
    {
public:
      UnableToFit(const char* file, int line, const char* function, const std::string& name, const std::string& message) noexcept;
    };

    class OPENMS_DLLAPI UnableToCalibrate :
      public BaseException
    {
public:
      UnableToCalibrate(const char* file, int line, const char* function, const std::string& name, const std::string& message) noexcept;
    };

    class OPENMS_DLLAPI DepletedIDPool :
      public BaseException
    {
public:
      DepletedIDPool(const char* file, int line, const char* function, const std::string& name, const std::string& message) noexcept;
    };

  } // namespace Exception

  OPENMS_DLLAPI std::ostream& operator<<(std::ostream& os, const Exception::BaseException& e);

} // namespace OPENMS