| // Standard exception classes -*- C++ -*- |
| |
| // Copyright (C) 2001-2013 Free Software Foundation, Inc. |
| // |
| // This file is part of the GNU ISO C++ Library. This library is free |
| // software; you can redistribute it and/or modify it under the |
| // terms of the GNU General Public License as published by the |
| // Free Software Foundation; either version 3, or (at your option) |
| // any later version. |
| |
| // This library is distributed in the hope that it will be useful, |
| // but WITHOUT ANY WARRANTY; without even the implied warranty of |
| // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| // GNU General Public License for more details. |
| |
| // Under Section 7 of GPL version 3, you are granted additional |
| // permissions described in the GCC Runtime Library Exception, version |
| // 3.1, as published by the Free Software Foundation. |
| |
| // You should have received a copy of the GNU General Public License and |
| // a copy of the GCC Runtime Library Exception along with this program; |
| // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see |
| // <http://www.gnu.org/licenses/>. |
| |
| /** @file include/stdexcept |
| * This is a Standard C++ Library header. |
| */ |
| |
| // |
| // ISO C++ 19.1 Exception classes |
| // |
| |
| #ifndef _GLIBCXX_STDEXCEPT |
| #define _GLIBCXX_STDEXCEPT 1 |
| |
| #pragma GCC system_header |
| |
| #include <exception> |
| #include <string> |
| |
| namespace std _GLIBCXX_VISIBILITY(default) |
| { |
| _GLIBCXX_BEGIN_NAMESPACE_VERSION |
| |
| /** |
| * @addtogroup exceptions |
| * @{ |
| */ |
| |
| /** Logic errors represent problems in the internal logic of a program; |
| * in theory, these are preventable, and even detectable before the |
| * program runs (e.g., violations of class invariants). |
| * @brief One of two subclasses of exception. |
| */ |
| class logic_error : public exception |
| { |
| string _M_msg; |
| |
| public: |
| /** Takes a character string describing the error. */ |
| explicit |
| logic_error(const string& __arg); |
| |
| virtual ~logic_error() _GLIBCXX_USE_NOEXCEPT; |
| |
| /** Returns a C-style character string describing the general cause of |
| * the current error (the same string passed to the ctor). */ |
| virtual const char* |
| what() const _GLIBCXX_USE_NOEXCEPT; |
| }; |
| |
| /** Thrown by the library, or by you, to report domain errors (domain in |
| * the mathematical sense). */ |
| class domain_error : public logic_error |
| { |
| public: |
| explicit domain_error(const string& __arg); |
| virtual ~domain_error() _GLIBCXX_USE_NOEXCEPT; |
| }; |
| |
| /** Thrown to report invalid arguments to functions. */ |
| class invalid_argument : public logic_error |
| { |
| public: |
| explicit invalid_argument(const string& __arg); |
| virtual ~invalid_argument() _GLIBCXX_USE_NOEXCEPT; |
| }; |
| |
| /** Thrown when an object is constructed that would exceed its maximum |
| * permitted size (e.g., a basic_string instance). */ |
| class length_error : public logic_error |
| { |
| public: |
| explicit length_error(const string& __arg); |
| virtual ~length_error() _GLIBCXX_USE_NOEXCEPT; |
| }; |
| |
| /** This represents an argument whose value is not within the expected |
| * range (e.g., boundary checks in basic_string). */ |
| class out_of_range : public logic_error |
| { |
| public: |
| explicit out_of_range(const string& __arg); |
| virtual ~out_of_range() _GLIBCXX_USE_NOEXCEPT; |
| }; |
| |
| /** Runtime errors represent problems outside the scope of a program; |
| * they cannot be easily predicted and can generally only be caught as |
| * the program executes. |
| * @brief One of two subclasses of exception. |
| */ |
| class runtime_error : public exception |
| { |
| string _M_msg; |
| |
| public: |
| /** Takes a character string describing the error. */ |
| explicit |
| runtime_error(const string& __arg); |
| |
| virtual ~runtime_error() _GLIBCXX_USE_NOEXCEPT; |
| |
| /** Returns a C-style character string describing the general cause of |
| * the current error (the same string passed to the ctor). */ |
| virtual const char* |
| what() const _GLIBCXX_USE_NOEXCEPT; |
| }; |
| |
| /** Thrown to indicate range errors in internal computations. */ |
| class range_error : public runtime_error |
| { |
| public: |
| explicit range_error(const string& __arg); |
| virtual ~range_error() _GLIBCXX_USE_NOEXCEPT; |
| }; |
| |
| /** Thrown to indicate arithmetic overflow. */ |
| class overflow_error : public runtime_error |
| { |
| public: |
| explicit overflow_error(const string& __arg); |
| virtual ~overflow_error() _GLIBCXX_USE_NOEXCEPT; |
| }; |
| |
| /** Thrown to indicate arithmetic underflow. */ |
| class underflow_error : public runtime_error |
| { |
| public: |
| explicit underflow_error(const string& __arg); |
| virtual ~underflow_error() _GLIBCXX_USE_NOEXCEPT; |
| }; |
| |
| // @} group exceptions |
| |
| _GLIBCXX_END_NAMESPACE_VERSION |
| } // namespace |
| |
| #endif /* _GLIBCXX_STDEXCEPT */ |