wtkexcept.h

   1 #ifndef WTKEXCEPT_H
   2 /*
   3  * wtkexcept.h
   4  *
   5  * ---------------------------------------------------------------------------
   6  *
   7  * Implementation of a minimal C++ class framework for use with the
   8  * Microsoft Windows Application Programming Interface.
   9  *
  10  * $Id$
  11  *
  12  * This header file declares the exception class WTK::runtime_error.
  13  * It is implicitly included when including wtkplus.h, but may also be
  14  * explicitly included by any application which wishes to use the WTK
  15  * exception class, without the rest of the WTK C++ class framework.
  16  *
  17  * Written by Keith Marshall <keithmarshall@users.sourceforge.net>
  18  * Copyright (C) 2012, MinGW.org Project.
  19  *
  20  * Based on the implementation of mingw-get's dmh_exception class
  21  * Originally written by Charles Wilson <cwilso11@users.sourceforge.net>
  22  *
  23  * ---------------------------------------------------------------------------
  24  *
  25  * Permission is hereby granted, free of charge, to any person obtaining a
  26  * copy of this software and associated documentation files (the "Software"),
  27  * to deal in the Software without restriction, including without limitation
  28  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  29  * and/or sell copies of the Software, and to permit persons to whom the
  30  * Software is furnished to do so, subject to the following conditions:
  31  *
  32  * The above copyright notice, this permission notice, and the following
  33  * disclaimer shall be included in all copies or substantial portions of
  34  * the Software.
  35  *
  36  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  37  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  38  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  39  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  40  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  41  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  42  * DEALINGS IN THE SOFTWARE.
  43  *
  44  * ---------------------------------------------------------------------------
  45  *
  46  */
  47 #define WTKEXCEPT_H  1
  48
  49 #include <exception>
  50
  51 namespace WTK
  52 {
  53   class runtime_error: public std::exception
  54   {
  55     /* An exception class, similar to std::runtime_error, but using
  56      * a "const char *" rather than a "std::string" to categorise and
  57      * describe the exception.
  58      */
  59     public:
  60       runtime_error() throw();
  61       runtime_error( const char * ) throw();
  62       virtual const char *what() const throw();
  63       virtual ~runtime_error() throw(){}
  64
  65     protected:
  66       const char *message;
  67   };
  68
  69   class error_text
  70   {
  71     /* A helper class to dynamically place message text, up to a
  72      * maximum of 256 characters, into a static buffer whence it
  73      * may be retrieved on catching a runtime_error exception.
  74      */
  75     public:
  76       error_text( const char *, ... ) throw();
  77       operator const char *() const throw(){ return message; }
  78
  79     private:
  80       static char message[256];
  81   };
  82 }
  83
  84 #endif /* ! WTKEXCEPT_H: $RCSfile$: end of file */