Errorhandler

Classes
class	pqxx::errorhandler
class	pqxx::quiet_errorhandler

Detailed Description

---

Class Documentation

class pqxx::errorhandler

Deprecated:

Base class for obsolete error-handler callbacks.

This method of handling errors is obsolete. Use a "notice handler" instead.

Warning

Strange things happen when a result object outlives its parent connection. If you register an error handler on a connection, then you must not access the result after destroying the connection. This applies even if you destroy the error handler first!

Inheritance diagram for pqxx::errorhandler:

Public Member Functions
	errorhandler (connection &)
virtual bool	operator() (char const msg[]) noexcept=0
	errorhandler (errorhandler const &)=delete
errorhandler &	operator= (errorhandler const &)=delete
Friends
class	internal::gate::errorhandler_connection

Constructor & Destructor Documentation

pqxx::errorhandler::errorhandler ( connection &  cx )

explicit

Implementation of pqxx::errorhandler and helpers.

pqxx::errorhandler allows programs to receive errors and warnings.

Copyright (c) 2000-2025, Jeroen T. Vermeulen.

See COPYING for copyright license. If you did not receive a file called COPYING with this source code, please notify the distributor of this mistake, or contact the author.

Member Function Documentation

virtual bool pqxx::errorhandler::operator() ( char const  msg[] )

pure virtualnoexcept

Define in subclass: receive an error or warning message from the database.

Returns

Whether the same error message should also be passed to the remaining, older errorhandlers.

Implemented in pqxx::quiet_errorhandler.

class pqxx::quiet_errorhandler

Deprecated:

Use a notice handler instead.

Inheritance diagram for pqxx::quiet_errorhandler:

Public Member Functions
	quiet_errorhandler (connection &cx)
	Suppress error notices.
virtual bool	operator() (char const []) noexcept override
	End a code block started by "ignore-deprecated-pre.hxx". More...
Public Member Functions inherited from pqxx::errorhandler
	errorhandler (connection &)
	errorhandler (errorhandler const &)=delete
errorhandler &	operator= (errorhandler const &)=delete

Member Function Documentation

virtual bool pqxx::quiet_errorhandler::operator() ( char  const[] )

inlineoverridevirtualnoexcept

End a code block started by "ignore-deprecated-pre.hxx".

Revert to previous handling of error notices.

Implements pqxx::errorhandler.