LSSTApplications  19.0.0-14-gb0260a2+1b4fc4249b,20.0.0+19029f0d82,20.0.0+66077e84be,20.0.0+b8df9e862d,20.0.0+e2e26847c2,20.0.0+e47e9b3a81,20.0.0-1-g253301a+19029f0d82,20.0.0-1-g2b7511a+46a6078777,20.0.0-1-g3dda6ea+905cef1a44,20.0.0-1-g4d801e7+5fcfd52d2e,20.0.0-1-g5b95a8c+19889959e1,20.0.0-1-gc96f8cb+d5e4df5959,20.0.0-1-gedffbd8+6ca2c30637,20.0.0-10-g0891cd99+caa8c2603a,20.0.0-13-gad96b2d30+614f89f815,20.0.0-17-gcdbda88+2b141d441d,20.0.0-2-g4dae9ad+d5e4df5959,20.0.0-2-g52fdb94+046030bafd,20.0.0-2-g61b8584+85c46248f3,20.0.0-2-g8177d33+f2ab36af31,20.0.0-2-gb780d76+f45b7d88f4,20.0.0-2-gf072044+19029f0d82,20.0.0-22-gdf434b7+d5e4df5959,20.0.0-23-g10eeb28+452d7a9290,20.0.0-23-g8900aa8+a8b4322b0e,20.0.0-3-g1653f94+85c46248f3,20.0.0-3-g4cc78c6+63636aeed8,20.0.0-3-g750bffe+7a989609f2,20.0.0-3-gbd60e8c+ff10c6d78d,20.0.0-33-g078e64d5+a2256d2c79,20.0.0-4-g97dc21a+a8b4322b0e,20.0.0-4-gfea843c+f45b7d88f4,20.0.0-5-g357b56b+f45b7d88f4,20.0.0-6-g9a5b7a1+3d4d12ed4e,20.0.0-61-g4de25fb+ddf3488217,20.0.0-7-gcda7bf1+dffc53c16b,w.2020.44
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.
base.h
lsst.pex::exceptions::Traceback
std::vector< Tracepoint > Traceback
Definition: Exception.h:95
std::vector< Tracepoint >
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_EXPORT
#define LSST_EXPORT
Make a symbol visible even if visiblity is hidden (e.g.
Definition: base.h:54
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