Loading [MathJax]/extensions/tex2jax.js
LSST Applications g0fba68d861+aa97b6e50c,g1ec0fe41b4+f536777771,g1fd858c14a+a9301854fb,g35bb328faa+fcb1d3bbc8,g4af146b050+a5c07d5b1d,g4d2262a081+78f4f01b60,g53246c7159+fcb1d3bbc8,g56a49b3a55+9c12191793,g5a012ec0e7+3632fc3ff3,g60b5630c4e+ded28b650d,g67b6fd64d1+ed4b5058f4,g78460c75b0+2f9a1b4bcd,g786e29fd12+cf7ec2a62a,g8352419a5c+fcb1d3bbc8,g87b7deb4dc+7b42cf88bf,g8852436030+e5453db6e6,g89139ef638+ed4b5058f4,g8e3bb8577d+d38d73bdbd,g9125e01d80+fcb1d3bbc8,g94187f82dc+ded28b650d,g989de1cb63+ed4b5058f4,g9d31334357+ded28b650d,g9f33ca652e+50a8019d8c,gabe3b4be73+1e0a283bba,gabf8522325+fa80ff7197,gb1101e3267+d9fb1f8026,gb58c049af0+f03b321e39,gb89ab40317+ed4b5058f4,gcf25f946ba+e5453db6e6,gcf6002c91b+2a0c9e9e84,gd6cbbdb0b4+bb83cc51f8,gdd1046aedd+ded28b650d,gde0f65d7ad+66b3a48cb7,ge278dab8ac+d65b3c2b70,ge410e46f29+ed4b5058f4,gf23fb2af72+b7cae620c0,gf5e32f922b+fcb1d3bbc8,gf67bdafdda+ed4b5058f4,w.2025.16
LSST Data Management Base Package
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Modules Pages
Exception.h File Reference
#include <exception>
#include <ostream>
#include <string>
#include <vector>
#include "lsst/base.h"
#include "boost/current_function.hpp"

Go to the source code of this file.

Classes

struct  lsst.pex::exceptions::Tracepoint
 One point in the Traceback vector held by Exception. More...
 
class  lsst.pex::exceptions::Exception
 Provides consistent interface for LSST exceptions. More...
 

Namespaces

namespace  lsst
 
namespace  lsst.pex
 
namespace  lsst::pex::exceptions
 

Macros

#define LSST_EXCEPT_HERE   __FILE__, __LINE__, BOOST_CURRENT_FUNCTION
 For internal use; gathers the file, line, and function for a tracepoint.
 
#define LSST_EXCEPT(type, ...)
 Create an exception with a given type.
 
#define LSST_EXCEPT_ADD(e, m)
 Add the current location and a message to an existing exception before rethrowing it.
 
#define LSST_EARGS_TYPED   char const *ex_file, int ex_line, char const *ex_func, std::string const &ex_message
 The initial arguments required for new exception subclasses.
 
#define LSST_EARGS_UNTYPED   ex_file, ex_line, ex_func, ex_message
 The initial arguments to the base class constructor for new subclasses.
 
#define LSST_EXCEPTION_TYPE(t, b, c)
 Macro used to define new types of exceptions without additional data.
 

Typedefs

typedef std::vector< Tracepointlsst::pex::exceptions::Traceback
 

Functions

std::ostreamlsst::pex::exceptions::operator<< (std::ostream &stream, Exception const &e)
 Push the text representation of an exception onto a stream.
 

Macro Definition Documentation

◆ LSST_EARGS_TYPED

#define LSST_EARGS_TYPED   char const *ex_file, int ex_line, char const *ex_func, std::string const &ex_message

The initial arguments required for new exception subclasses.

Definition at line 57 of file Exception.h.

◆ LSST_EARGS_UNTYPED

#define LSST_EARGS_UNTYPED   ex_file, ex_line, ex_func, ex_message

The initial arguments to the base class constructor for new subclasses.

Definition at line 60 of file Exception.h.

◆ LSST_EXCEPT

#define LSST_EXCEPT ( type,
... )
Value:
type(LSST_EXCEPT_HERE, __VA_ARGS__)
#define LSST_EXCEPT_HERE
For internal use; gathers the file, line, and function for a tracepoint.
Definition Exception.h:40

Create an exception with a given type.

Parameters
[in]typeC++ type of the exception to be thrown.
[in]...The message, and optionally other arguments (dependent on the type).

Definition at line 48 of file Exception.h.

◆ LSST_EXCEPT_ADD

#define LSST_EXCEPT_ADD ( e,
m )
Value:
e.addMessage(LSST_EXCEPT_HERE, m)

Add the current location and a message to an existing exception before rethrowing it.

Definition at line 54 of file Exception.h.

◆ LSST_EXCEPT_HERE

#define LSST_EXCEPT_HERE   __FILE__, __LINE__, BOOST_CURRENT_FUNCTION

For internal use; gathers the file, line, and function for a tracepoint.

Definition at line 40 of file Exception.h.

◆ LSST_EXCEPTION_TYPE

#define LSST_EXCEPTION_TYPE ( t,
b,
c )
Value:
class LSST_EXPORT t : public b { \
public: \
t(std::string const& message) : b(message){}; \
virtual char const* getType(void) const noexcept { return #c " *"; }; \
virtual lsst::pex::exceptions::Exception* clone(void) const { return new t(*this); }; \
};
#define LSST_EARGS_UNTYPED
The initial arguments to the base class constructor for new subclasses.
Definition Exception.h:60
#define LSST_EARGS_TYPED
The initial arguments required for new exception subclasses.
Definition Exception.h:57
#define LSST_EXPORT
Make a symbol visible even if visiblity is hidden (e.g.
Definition base.h:37

Macro used to define new types of exceptions without additional data.

Parameters
[in]tType of the exception.
[in]bBase class of the exception.
[in]cC++ class of the exception (fully specified).

Definition at line 69 of file Exception.h.

69#define LSST_EXCEPTION_TYPE(t, b, c) \
70 class LSST_EXPORT t : public b { \
71 public: \
72 t(LSST_EARGS_TYPED) : b(LSST_EARGS_UNTYPED){}; \
73 t(std::string const& message) : b(message){}; \
74 virtual char const* getType(void) const noexcept { return #c " *"; }; \
75 virtual lsst::pex::exceptions::Exception* clone(void) const { return new t(*this); }; \
76 };