errorhandler.hxx

Go to the documentation of this file.

/* Definition of the pqxx::errorhandler class.
 *
 * pqxx::errorhandler handlers errors and warnings in a database session.
 *
 * DO NOT INCLUDE THIS FILE DIRECTLY; include pqxx/errorhandler instead.
 *
 * Copyright (c) 2000-2026, 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.
 */
#ifndef PQXX_ERRORHANDLER_HXX
#define PQXX_ERRORHANDLER_HXX
 
#if !defined(PQXX_HEADER_PRE)
#  error "Include libpqxx headers as <pqxx/header>, not <pqxx/header.hxx>."
#endif
 
#include "pqxx/types.hxx"
 
 
namespace pqxx::internal::gate
{
class errorhandler_connection;
} // namespace pqxx::internal::gate
 
 
namespace pqxx
{
 
 
class PQXX_LIBEXPORT errorhandler
{
public:
  [[deprecated("Use a notice handler instead.")]]
  explicit errorhandler(connection &);
  virtual ~errorhandler();
 
 
  PQXX_ZARGS virtual bool operator()(char const msg[]) noexcept = 0;
 
  errorhandler() = delete;
  errorhandler(errorhandler const &) = delete;
  errorhandler(errorhandler &&) = delete;
  errorhandler &operator=(errorhandler const &) = delete;
  errorhandler &operator=(errorhandler &&) = delete;
 
private:
  connection *m_home;
 
  friend class internal::gate::errorhandler_connection;
  void unregister() noexcept;
};
 
 
class quiet_errorhandler : public errorhandler
{
public:
#include "pqxx/internal/ignore-deprecated-pre.hxx"
  [[deprecated("Use notice handlers instead.")]]
  explicit quiet_errorhandler(connection &cx) :
          errorhandler{cx}
  {}
#include "pqxx/internal/ignore-deprecated-post.hxx"
 
  PQXX_ZARGS bool operator()(char const[]) noexcept override { return false; }
 
  quiet_errorhandler() = delete;
};
 
} // namespace pqxx
#endif