pqxx::pqxx_exception Class Reference

Mixin base class to identify libpqxx-specific exception types. More...

#include <except.hxx>

Inheritance diagram for pqxx::pqxx_exception:

Public Member Functions
virtual	~pqxx_exception ()=0 throw ()
	Support run-time polymorphism, and keep this class abstract. More...
virtual const PQXX_CONST PGSTD::exception &	base () const =0 throw ()
	Return std::exception base-class object. More...

Detailed Description

Mixin base class to identify libpqxx-specific exception types.

If you wish to catch all exception types specific to libpqxx for some reason, catch this type. All of libpqxx's exception classes are derived from it through multiple-inheritance (they also fit into the standard library's exception hierarchy in more fitting places).

This class is not derived from std::exception, since that could easily lead to exception classes with multiple std::exception base-class objects. As Bart Samwel points out, "catch" is subject to some nasty fineprint in such cases.

Constructor & Destructor Documentation

virtual pqxx::pqxx_exception::~pqxx_exception ( ) throw ()

pure virtual

Support run-time polymorphism, and keep this class abstract.

Member Function Documentation

virtual const PQXX_CONST PGSTD::exception& pqxx::pqxx_exception::base ( ) const throw ()

pure virtual

Return std::exception base-class object.

Use this to get at the exception's what() function, or to downcast to a more specific type using dynamic_cast.

Casting directly from pqxx_exception to a specific exception type is not likely to work since pqxx_exception is not (and could not safely be) derived from std::exception.

For example, to test dynamically whether an exception is an sql_error:

try
{
  // ...
}
catch (const pqxx::pqxx_exception &e)
{
  std::cerr << e.base().what() << std::endl;
  const pqxx::sql_error *s=dynamic_cast<const pqxx::sql_error*>(&e.base());
  if (s) std::cerr << "Query was: " << s->query() << std::endl;
}

Implemented in pqxx::range_error, pqxx::conversion_error, pqxx::argument_error, pqxx::usage_error, pqxx::internal_error, and pqxx::failure.

---

The documentation for this class was generated from the following file:

• /usr/include/pqxx/except.hxx