LSSTApplications  19.0.0-14-gb0260a2+72efe9b372,20.0.0+7927753e06,20.0.0+8829bf0056,20.0.0+995114c5d2,20.0.0+b6f4b2abd1,20.0.0+bddc4f4cbe,20.0.0-1-g253301a+8829bf0056,20.0.0-1-g2b7511a+0d71a2d77f,20.0.0-1-g5b95a8c+7461dd0434,20.0.0-12-g321c96ea+23efe4bbff,20.0.0-16-gfab17e72e+fdf35455f6,20.0.0-2-g0070d88+ba3ffc8f0b,20.0.0-2-g4dae9ad+ee58a624b3,20.0.0-2-g61b8584+5d3db074ba,20.0.0-2-gb780d76+d529cf1a41,20.0.0-2-ged6426c+226a441f5f,20.0.0-2-gf072044+8829bf0056,20.0.0-2-gf1f7952+ee58a624b3,20.0.0-20-geae50cf+e37fec0aee,20.0.0-25-g3dcad98+544a109665,20.0.0-25-g5eafb0f+ee58a624b3,20.0.0-27-g64178ef+f1f297b00a,20.0.0-3-g4cc78c6+e0676b0dc8,20.0.0-3-g8f21e14+4fd2c12c9a,20.0.0-3-gbd60e8c+187b78b4b8,20.0.0-3-gbecbe05+48431fa087,20.0.0-38-ge4adf513+a12e1f8e37,20.0.0-4-g97dc21a+544a109665,20.0.0-4-gb4befbc+087873070b,20.0.0-4-gf910f65+5d3db074ba,20.0.0-5-gdfe0fee+199202a608,20.0.0-5-gfbfe500+d529cf1a41,20.0.0-6-g64f541c+d529cf1a41,20.0.0-6-g9a5b7a1+a1cd37312e,20.0.0-68-ga3f3dda+5fca18c6a4,20.0.0-9-g4aef684+e18322736b,w.2020.45
LSSTDataManagementBasePackage
Exception.h
Go to the documentation of this file.
1 /*
2  * This file is part of pex_exceptions.
3  *
4  * Developed for the LSST Data Management System.
5  * This product includes software developed by the LSST Project
6  * (https://www.lsst.org).
7  * See the COPYRIGHT file at the top-level directory of this distribution
8  * for details of code ownership.
9  *
10  * This program is free software: you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation, either version 3 of the License, or
13  * (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License
21  * along with this program. If not, see <https://www.gnu.org/licenses/>.
22  */
23 
24 #ifndef LSST_PEX_EXCEPTIONS_EXCEPTION_H
25 #define LSST_PEX_EXCEPTIONS_EXCEPTION_H
26 
27 #include <exception>
28 #include <ostream>
29 #include <string>
30 #include <vector>
31 
32 #include "lsst/base.h"
33 #include "boost/current_function.hpp"
34 
35 namespace lsst {
36 namespace pex {
37 namespace exceptions {
38 
40 #define LSST_EXCEPT_HERE __FILE__, __LINE__, BOOST_CURRENT_FUNCTION
41 
48 #define LSST_EXCEPT(type, ...) type(LSST_EXCEPT_HERE, __VA_ARGS__)
49 
54 #define LSST_EXCEPT_ADD(e, m) e.addMessage(LSST_EXCEPT_HERE, m)
55 
57 #define LSST_EARGS_TYPED char const *ex_file, int ex_line, char const *ex_func, std::string const &ex_message
58 
60 #define LSST_EARGS_UNTYPED ex_file, ex_line, ex_func, ex_message
61 
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  };
77 
79 struct Tracepoint {
88  Tracepoint(char const* file, int line, char const* func, std::string const& message);
89 
90  char const* _file; // Compiled strings only; does not need deletion
91  int _line;
92  char const* _func; // Compiled strings only; does not need deletion
94 };
96 
108 public:
117  Exception(char const* file, int line, char const* func,
118  std::string const& message); // Should use LSST_EARGS_TYPED, but that confuses doxygen.
119 
130  explicit Exception(std::string const& message);
131 
132  virtual ~Exception(void) noexcept;
133 
142  void addMessage(char const* file, int line, char const* func, std::string const& message);
143 
145  Traceback const& getTraceback(void) const noexcept;
146 
154  virtual std::ostream& addToStream(std::ostream& stream) const;
155 
166  virtual char const* what(void) const noexcept;
167 
175  virtual char const* getType(void) const noexcept;
176 
183  virtual Exception* clone(void) const;
184 
185 private:
186  std::string _message;
187  Traceback _traceback;
188 };
189 
197 std::ostream& operator<<(std::ostream& stream, Exception const& e);
198 }
199 } // namespace pex
200 } // namespace lsst
201 
202 #endif
lsst.pex::exceptions::Tracepoint::Tracepoint
Tracepoint(char const *file, int line, char const *func, std::string const &message)
Standard constructor, intended for C++ use.
Definition: Exception.cc:39
lsst.pex::exceptions::Tracepoint::_func
char const * _func
Definition: Exception.h:92
std::string
STL class.
std::exception
STL class.
lsst.pex::exceptions::Traceback
std::vector< Tracepoint > Traceback
Definition: Exception.h:95
std::vector< Tracepoint >
base.h
std::ostream
STL class.
lsst::afw.display.ds9.line
def line(points, frame=None, origin=afwImage.PARENT, symbs=False, ctype=None, size=0.5)
Definition: ds9.py:105
lsst.pex::exceptions::Tracepoint::_file
char const * _file
Definition: Exception.h:90
lsst
A base class for image defects.
Definition: imageAlgorithm.dox:1
lsst.display.ds9.ds9.file
file
Definition: ds9.py:39
lsst.pex::exceptions::operator<<
std::ostream & operator<<(std::ostream &stream, Exception const &e)
Push the text representation of an exception onto a stream.
Definition: Exception.cc:105
lsst.pex::exceptions::Exception
Provides consistent interface for LSST exceptions.
Definition: Exception.h:107
lsst.pex::exceptions::Tracepoint::_message
std::string _message
Definition: Exception.h:93
lsst.pex::exceptions::Tracepoint
One point in the Traceback vector held by Exception.
Definition: Exception.h:79
lsst.pex::exceptions::Tracepoint::_line
int _line
Definition: Exception.h:91
lsst::afw::image.slicing.clone
clone
Definition: slicing.py:257
LSST_EXPORT
#define LSST_EXPORT
Make a symbol visible even if visiblity is hidden (e.g.
Definition: base.h:54