exceptions.h

Go to the documentation of this file.

/***********************************************************************
 Copyright © 1998 by Kevin Atkinson, © 1999-2001 by MySQL AB, and
 © 2004-2010, 2018 by Educational Technology Resources, Inc.  Others may
 also hold copyrights on code in this file.  See the CREDITS.txt file
 in the top directory of the distribution for details.

 This file is part of MySQL++.

 MySQL++ is free software; you can redistribute it and/or modify it
 under the terms of the GNU Lesser General Public License as published
 by the Free Software Foundation; either version 2.1 of the License, or
 (at your option) any later version.

 MySQL++ 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.

 You should have received a copy of the GNU Lesser General Public
 License along with MySQL++; if not, write to the Free Software
 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
 USA
***********************************************************************/

#if !defined(MYSQLPP_EXCEPTIONS_H)
#define MYSQLPP_EXCEPTIONS_H

#include "options.h"

#include <exception>
#include <string>
#include <sstream>
#include <typeinfo>

namespace mysqlpp {


class MYSQLPP_EXPORT Exception : public std::exception
{
public:
        Exception(const Exception& e) MAY_THROW() :
        std::exception(e),
        what_(e.what_)
        {
        }

        Exception& operator=(const Exception& rhs) throw()
        {
                what_ = rhs.what_;
                return *this;
        }

        ~Exception() throw() { }

        virtual const char* what() const throw()
        {
                return what_.c_str();
        }

protected:
        Exception(const char* w = "") throw() :
        what_(w)
        {
        }

        Exception(const std::string& w) throw() :
        what_(w)
        {
        }

        std::string what_;
};



class MYSQLPP_EXPORT BadConversion : public Exception
{
public:
        const char* type_name;  
        std::string data;               
        size_t retrieved;               
        size_t actual_size;             

        BadConversion(const char* tn, const char* d,
                        size_t r, size_t a) :
        Exception("Bad type conversion: \""),
        type_name(tn),
        data(d),
        retrieved(r),
        actual_size(a)
        {
                what_ += d ? d : "<NULL>";
                what_ += "\" incompatible with \"";
                what_ += tn;
                what_ += "\" type";
        }

        BadConversion(const std::string& w, const char* tn,
                                  const char* d, size_t r, size_t a) :
        Exception(w),
        type_name(tn),
        data(d),
        retrieved(r),
        actual_size(a)
        {
        }

        explicit BadConversion(const char* w = "") :
        Exception(w),
        type_name("unknown"),
        data(""),
        retrieved(0),
        actual_size(0)
        {
        }

        ~BadConversion() throw() { }
};



class MYSQLPP_EXPORT BadFieldName : public Exception
{
public:
        explicit BadFieldName(const char* bad_field) :
        Exception(std::string("Unknown field name: ") + bad_field)
        {
        }

        ~BadFieldName() throw() { }
};



class MYSQLPP_EXPORT BadIndex : public Exception
{
public:
        explicit BadIndex(const char* what, int bad_index, int max_index) :
        Exception()
        {
                std::ostringstream outs;
                outs << "Index " << bad_index << " on " << what <<
                                " out of range, max legal index is " << max_index;
                what_ = outs.str();
        }

        ~BadIndex() throw() { }
};



class MYSQLPP_EXPORT BadOption : public Exception
{
public:
        explicit BadOption(const char* w, const std::type_info& ti) :
        Exception(w),
        ti_(ti)
        {
        }

        explicit BadOption(const std::string& w, const std::type_info& ti) :
        Exception(w),
        ti_(ti)
        {
        }

        const std::type_info& what_option() const { return ti_; }

private:
        const std::type_info& ti_;
};



class MYSQLPP_EXPORT BadParamCount : public Exception
{
public:
        explicit BadParamCount(const char* w = "") :
        Exception(w)
        {
        }

        ~BadParamCount() throw() { }
};


class MYSQLPP_EXPORT UseQueryError : public Exception
{
public:
        explicit UseQueryError(const char* w = "") :
        Exception(w)
        {
        }
};



class MYSQLPP_EXPORT BadQuery : public Exception
{
public:
        explicit BadQuery(const char* w = "", int e = 0) :
        Exception(w),
        errnum_(e)
        {
        }

        explicit BadQuery(const std::string& w, int e = 0) :
        Exception(w),
        errnum_(e)
        {
        }

        int errnum() const { return errnum_; }
        
private:        
        int     errnum_;        
};



class MYSQLPP_EXPORT ConnectionFailed : public Exception
{
public:
        explicit ConnectionFailed(const char* w = "", int e = 0) :
        Exception(w),
        errnum_(e)
        {
        }

        int errnum() const { return errnum_; }
        
private:        
        int     errnum_;        
};



class MYSQLPP_EXPORT DBSelectionFailed : public Exception
{
public:
        explicit DBSelectionFailed(const char* w = "", int e = 0) :
        Exception(w),
        errnum_(e)
        {
        }

        int errnum() const { return errnum_; }
        
private:        
        int     errnum_;        
};



class MYSQLPP_EXPORT MutexFailed : public Exception
{
public:
        explicit MutexFailed(const char* w = "lock failed") :
        Exception(w)
        {
        }
};



class MYSQLPP_EXPORT ObjectNotInitialized : public Exception
{
public:
        explicit ObjectNotInitialized(const char* w = "") :
        Exception(w)
        {
        }
};



class MYSQLPP_EXPORT SelfTestFailed : public Exception
{
public:
        explicit SelfTestFailed(const std::string& w) :
        Exception(w)
        {
        }
};



class MYSQLPP_EXPORT TypeLookupFailed : public Exception
{
public:
        explicit TypeLookupFailed(const std::string& w) :
        Exception(w)
        {
        }
};



class MYSQLPP_EXPORT BadInsertPolicy : public Exception
{
public:
        explicit BadInsertPolicy(const std::string& w) :
        Exception(w)
        {
        }
};


} // end namespace mysqlpp

#endif // !defined(MYSQLPP_EXCEPTIONS_H)