stdexcept

Go to the documentation of this file.
00001 // Standard exception classes  -*- C++ -*-
00002 
00003 // Copyright (C) 2001, 2002, 2005, 2007, 2009 Free Software Foundation, Inc.
00004 //
00005 // This file is part of the GNU ISO C++ Library.  This library is free
00006 // software; you can redistribute it and/or modify it under the
00007 // terms of the GNU General Public License as published by the
00008 // Free Software Foundation; either version 3, or (at your option)
00009 // any later version.
00010 
00011 // This library is distributed in the hope that it will be useful,
00012 // but WITHOUT ANY WARRANTY; without even the implied warranty of
00013 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00014 // GNU General Public License for more details.
00015 
00016 // Under Section 7 of GPL version 3, you are granted additional
00017 // permissions described in the GCC Runtime Library Exception, version
00018 // 3.1, as published by the Free Software Foundation.
00019 
00020 // You should have received a copy of the GNU General Public License and
00021 // a copy of the GCC Runtime Library Exception along with this program;
00022 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
00023 // <http://www.gnu.org/licenses/>.
00024 
00025 /** @file stdexcept
00026  *  This is a Standard C++ Library header.
00027  */
00028 
00029 //
00030 // ISO C++ 19.1  Exception classes
00031 //
00032 
00033 #ifndef _GLIBCXX_STDEXCEPT
00034 #define _GLIBCXX_STDEXCEPT 1
00035 
00036 #pragma GCC system_header
00037 
00038 #include <exception>
00039 #include <string>
00040 
00041 _GLIBCXX_BEGIN_NAMESPACE(std)
00042 
00043   /**
00044    * @addtogroup exceptions
00045    * @{
00046    */
00047 
00048   /** Logic errors represent problems in the internal logic of a program;
00049    *  in theory, these are preventable, and even detectable before the
00050    *  program runs (e.g., violations of class invariants).
00051    *  @brief One of two subclasses of exception.
00052    */
00053   class logic_error : public exception 
00054   {
00055     string _M_msg;
00056 
00057   public:
00058     /** Takes a character string describing the error.  */
00059     explicit 
00060     logic_error(const string& __arg);
00061 
00062     virtual 
00063     ~logic_error() throw();
00064 
00065     /** Returns a C-style character string describing the general cause of
00066      *  the current error (the same string passed to the ctor).  */
00067     virtual const char* 
00068     what() const throw();
00069   };
00070 
00071   /** Thrown by the library, or by you, to report domain errors (domain in
00072    *  the mathematical sense).  */
00073   class domain_error : public logic_error 
00074   {
00075   public:
00076     explicit domain_error(const string& __arg);
00077   };
00078 
00079   /** Thrown to report invalid arguments to functions.  */
00080   class invalid_argument : public logic_error 
00081   {
00082   public:
00083     explicit invalid_argument(const string& __arg);
00084   };
00085 
00086   /** Thrown when an object is constructed that would exceed its maximum
00087    *  permitted size (e.g., a basic_string instance).  */
00088   class length_error : public logic_error 
00089   {
00090   public:
00091     explicit length_error(const string& __arg);
00092   };
00093 
00094   /** This represents an argument whose value is not within the expected
00095    *  range (e.g., boundary checks in basic_string).  */
00096   class out_of_range : public logic_error 
00097   {
00098   public:
00099     explicit out_of_range(const string& __arg);
00100   };
00101 
00102   /** Runtime errors represent problems outside the scope of a program;
00103    *  they cannot be easily predicted and can generally only be caught as
00104    *  the program executes.
00105    *  @brief One of two subclasses of exception.
00106    */
00107   class runtime_error : public exception 
00108   {
00109     string _M_msg;
00110 
00111   public:
00112     /** Takes a character string describing the error.  */
00113     explicit 
00114     runtime_error(const string& __arg);
00115 
00116     virtual 
00117     ~runtime_error() throw();
00118 
00119     /** Returns a C-style character string describing the general cause of
00120      *  the current error (the same string passed to the ctor).  */
00121     virtual const char* 
00122     what() const throw();
00123   };
00124 
00125   /** Thrown to indicate range errors in internal computations.  */
00126   class range_error : public runtime_error 
00127   {
00128   public:
00129     explicit range_error(const string& __arg);
00130   };
00131 
00132   /** Thrown to indicate arithmetic overflow.  */
00133   class overflow_error : public runtime_error 
00134   {
00135   public:
00136     explicit overflow_error(const string& __arg);
00137   };
00138 
00139   /** Thrown to indicate arithmetic underflow.  */
00140   class underflow_error : public runtime_error 
00141   {
00142   public:
00143     explicit underflow_error(const string& __arg);
00144   };
00145 
00146   // @} group exceptions
00147 
00148 _GLIBCXX_END_NAMESPACE
00149 
00150 #endif /* _GLIBCXX_STDEXCEPT */

Generated on Thu Jul 23 21:16:18 2009 for libstdc++ by  doxygen 1.5.8