/sqlite3cc : contents of include/sqlitepp/exception.hpp at revision 1

: (revision 1)

To get this branch, use:

bzr branch
http://bzr.ed.am/sqlite3cc

/*
 * exception.hpp
 *
 * Copyright (C) 2009 Tim Marston <edam@waxworlds.org>
 *
 * This file is part of sqlitepp (hereafter referred to as "this program").
 * See http://www.waxworlds.org/edam/software/sqlitepp for more information.
 *
 * This program 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 3 of the License, or
 * (at your option) any later version.
 *
 * This program 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef EXCEPTION_HPP_
#define EXCEPTION_HPP_


#include <sqlite3.h>
#include <stdexcept>


namespace sqlite
{


/**
 * Main (base) sqlite exception class.
 */
class sqlite_error
	:
	public std::exception
{
//______________________________________________________________________________
//                                                                 instantiation
public:

	/**
	 * Constructor that takes an sqlite error code and determines it's own
	 * error message
	 * @param error_code the sqlite error code
	 */
	sqlite_error(
		int error_code );

	/**
	 * Constructor that allows the creation of an sqlite error with a custom
	 * message.
	 * @param message a customer error message string
	 * @param error_code the sqlite error code
	 */
	sqlite_error(
		const std::string &message,
		int error_code = SQLITE_ERROR );

	virtual ~sqlite_error() throw( );

//______________________________________________________________________________
//                                                              public interface
public:

	/**
	 * Get the sqlite error code associated with this error
	 * @returns the sqlite error code
	 */
	int get_error_code() const;

	/**
	 * Get the error message
	 * @returns the error message
	 */
	virtual const char* what() const throw( );

//______________________________________________________________________________
//                                                                implementation
private:

	/**
	 * Retrieve an automatic error message for a given sqlite error code
	 * @param the sqlite error code
	 * @returns the automatic string
	 */
	const std::string &get_error_message(
		int error_code );

	/** the error code */
	int _error_code;

	/** the message string */
	std::string _message;

};


}


#endif /* EXCEPTION_HPP_ */

1 by edam - initial commit	1	/*
	2	* exception.hpp
	3	*
	4	* Copyright (C) 2009 Tim Marston <edam@waxworlds.org>
	5	*
	6	* This file is part of sqlitepp (hereafter referred to as "this program").
	7	* See http://www.waxworlds.org/edam/software/sqlitepp for more information.
	8	*
	9	* This program is free software: you can redistribute it and/or modify
	10	* it under the terms of the GNU Lesser General Public License as published
	11	* by the Free Software Foundation, either version 3 of the License, or
	12	* (at your option) any later version.
	13	*
	14	* This program is distributed in the hope that it will be useful,
	15	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	16	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	17	* GNU Lesser General Public License for more details.
	18	*
	19	* You should have received a copy of the GNU Lesser General Public License
	20	* along with this program. If not, see <http://www.gnu.org/licenses/>.
	21	*/
	22
	23	#ifndef EXCEPTION_HPP_
	24	#define EXCEPTION_HPP_
	25
	26
	27	#include <sqlite3.h>
	28	#include <stdexcept>
	29
	30
	31	namespace sqlite
	32	{
	33
	34
	35	/**
	36	* Main (base) sqlite exception class.
	37	*/
	38	class sqlite_error
	39	:
	40	public std::exception
	41	{
	42	//______________________________________________________________________________
	43	// instantiation
	44	public:
	45
	46	/**
	47	* Constructor that takes an sqlite error code and determines it's own
	48	* error message
	49	* @param error_code the sqlite error code
	50	*/
	51	sqlite_error(
	52	int error_code );
	53
	54	/**
	55	* Constructor that allows the creation of an sqlite error with a custom
	56	* message.
	57	* @param message a customer error message string
	58	* @param error_code the sqlite error code
	59	*/
	60	sqlite_error(
	61	const std::string &message,
	62	int error_code = SQLITE_ERROR );
	63
	64	virtual ~sqlite_error() throw( );
65
66	//______________________________________________________________________________
67	// public interface
68	public:
69
70	/**
71	* Get the sqlite error code associated with this error
72	* @returns the sqlite error code
73	*/
74	int get_error_code() const;
75
76	/**
77	* Get the error message
78	* @returns the error message
79	*/
80	virtual const char* what() const throw( );
81
82	//______________________________________________________________________________
83	// implementation
84	private:
85
86	/**
87	* Retrieve an automatic error message for a given sqlite error code
88	* @param the sqlite error code
89	* @returns the automatic string
90	*/
91	const std::string &get_error_message(
92	int error_code );
93
94	/** the error code */
95	int _error_code;
96
97	/** the message string */
98	std::string _message;
99
100	};
101
102
103	}
104
105
106	#endif /* EXCEPTION_HPP_ */