robot/include/cppdb/errors.h

///////////////////////////////////////////////////////////////////////////////
//                                                                             
//  Copyright (C) 2010-2011  Artyom Beilis (Tonkikh) <artyomtnk@yahoo.com>     
//                                                                             
//  Distributed under:
//
//                   the Boost Software License, Version 1.0.
//              (See accompanying file LICENSE_1_0.txt or copy at 
//                     http://www.boost.org/LICENSE_1_0.txt)
//
//  or (at your opinion) under:
//
//                               The MIT License
//                 (See accompanying file MIT.txt or a copy at
//              http://www.opensource.org/licenses/mit-license.php)
//
///////////////////////////////////////////////////////////////////////////////
#ifndef CPPDB_ERRORS_H
#define CPPDB_ERRORS_H
#include <stdexcept>
#include <string>

namespace cppdb {
	///
	/// \brief This is the base error of all errors thrown by cppdb.
	///
	class cppdb_error : public std::runtime_error {
	public:
		///
		/// Create a cppdb_error with error message \a v
		///
		cppdb_error(std::string const &v) : std::runtime_error(v) {}
	};

	///
	/// \brief invalid data conversions
	///
	/// It may be thrown if the data can't be converted to required format, for example trying to fetch
	/// a negative value with unsigned type or parsing invalid string as datatime.
	///
	class bad_value_cast : public cppdb_error {
	public:
		bad_value_cast() : cppdb_error("cppdb::bad_value_cast can't convert data")
		{
		}
	};

	///
	/// \brief attempt to fetch a null value.
	///
	/// Thrown by cppdb::result::get functions.
	///
	class null_value_fetch : public cppdb_error {
	public:
		null_value_fetch() : cppdb_error("cppdb::null_value_fetch attempt fetch null column")
		{
		}
	};
	///
	/// \brief attempt to fetch a value from the row without calling next() first time or when next() returned false.
	///
	class empty_row_access : public cppdb_error {
	public:
		empty_row_access() : cppdb_error("cppdb::empty_row_access attempt to fetch from empty column")
		{
		}
	};

	///
	/// \brief trying to fetch a value using invalid column index
	///
	class invalid_column : public cppdb_error {
	public:
		invalid_column() : cppdb_error("cppdb::invalid_column attempt access to invalid column")
		{
		}
	};
	///
	/// \brief trying to fetch a value using invalid placeholder
	///
	class invalid_placeholder : public cppdb_error {
	public:
		invalid_placeholder() : cppdb_error("cppdb::invalid_placeholder attempt bind to invalid placeholder")
		{
		}
	};
	///
	/// \brief trying to fetch a single row for a query that returned multiple ones.
	///
	class multiple_rows_query : public cppdb_error {
	public:
		multiple_rows_query() : cppdb_error(	"cppdb::multiple_rows_query "
							"multiple rows result for a single row request")
		{
		}
	};

	///
	/// \brief This operation is not supported by the backend
	///
	class not_supported_by_backend : public cppdb_error {
	public:
		///
		/// Create a not_supported_by_backend with error message \a e
		///
		not_supported_by_backend(std::string const &e) :
			cppdb_error(e)
		{
		}
	};

}

#endif