LSSTApplications  21.0.0+1b62c9342b,21.0.0+45a059f35e,21.0.0-1-ga51b5d4+ceb9cf20a3,21.0.0-17-gf9a0284+9e5b25d042,21.0.0-2-g103fe59+513edb8842,21.0.0-2-g1367e85+d9bb5204cb,21.0.0-2-g2909d54+45a059f35e,21.0.0-2-g45278ab+1b62c9342b,21.0.0-2-g4bc9b9f+36532ac5d2,21.0.0-2-g5242d73+d9bb5204cb,21.0.0-2-g54e2caa+0b4b33a26b,21.0.0-2-g66bcc37+0525a04256,21.0.0-2-g7f82c8f+8938dec807,21.0.0-2-g8dde007+7bfb5851c8,21.0.0-2-g8f08a60+73884b2cf5,21.0.0-2-g973f35b+44678ca34c,21.0.0-2-ga326454+8938dec807,21.0.0-2-ga63a54e+682c8ce20e,21.0.0-2-ga885a99+9a92674037,21.0.0-2-gc738bc1+5ce50b2a03,21.0.0-2-gde069b7+5a8f2956b8,21.0.0-2-ge17e5af+d9bb5204cb,21.0.0-2-ge712728+d5c34dc911,21.0.0-2-gecfae73+8bdf007ced,21.0.0-2-gfc62afb+d9bb5204cb,21.0.0-21-g006371a9+5abec3504c,21.0.0-3-g4c5b185+4e2de95c30,21.0.0-3-g6d51c4a+0525a04256,21.0.0-3-gaa929c8+fca53d2b73,21.0.0-3-gd222c45+afc8332dbe,21.0.0-3-gd5de2f2+0525a04256,21.0.0-4-g3300ddd+1b62c9342b,21.0.0-4-g8a80011+23661db33a,21.0.0-5-gb7080ec+ee9551b7be,21.0.0-5-gcff38f6+e51f0852ce,21.0.0-6-gd3283ba+fca53d2b73,21.0.0-8-g19111d86+898b2b281f,21.0.0-8-gd9c33f4a0+b58bb1f4d6,w.2021.03
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
Basic LSST definitions.
LSST_EXPORT
#define LSST_EXPORT
Make a symbol visible even if visiblity is hidden (e.g.
Definition: base.h:54
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