Exception.h

/*
 * exception.h - environmetal, or usage error Exception classes.
 *
 * This file is part of the Rulbus Device Class Library (RDCL).
 *
 * Copyright (C) 2003-2004, Leiden University.
 *
 * 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 2 of the License, or
 * (at your option) any later version.
 *
 * The 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.
 *
 * You should have received a copy of the GNU General Public License
 * along with mngdriver; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * $Id: Exception.h 2 2004-10-12 11:54:15Z moene $
 */

#ifndef __EXCEPTION_H
#define __EXCEPTION_H

#ifndef __COMMON_H
   #include "Common.h"
#endif

#include <stdexcept>            // for standard exceptions

#if __BCPLUSPLUS__ < 0x0560
   using std::__threadid;       // needed for Borland C++ 5.5.1; _stddef.h apparently errs
#endif

namespace Rulbus
{
   DECLARE_CLASS( RulbusError          );       
   DECLARE_CLASS( RulbusScanError      );       
   DECLARE_CLASS( RulbusParseError     );       
   DECLARE_CLASS( RulbusConfigError    );       
   DECLARE_CLASS( RulbusInterfaceError );       
   DECLARE_CLASS( RulbusOpenError      );       
   DECLARE_CLASS( RulbusCloseError     );       
   DECLARE_CLASS( RulbusHandleError    );       
   DECLARE_CLASS( RulbusAddressError   );       
   DECLARE_CLASS( RulbusRangeError     );       
   DECLARE_CLASS( RulbusContextError   );       
   DECLARE_CLASS( RulbusTimeoutError   );       

   inline CharCptr to_cstr( const String& s )
   {
      return s.c_str();
   }

   class RulbusError : public StdException
   {
   public:

      RulbusError() { tid = _threadid; theError = *this; }

      RulbusError( CharCptr fmt ... );

      // RulbusError(CharCptr fmt, va_list ap );

      RulbusError( StringCref string );

      RulbusError( StdExceptionCref e ) { msg = e.what(); tid = _threadid; theError = *this; }

      RulbusError( RulbusErrorCref e ) { msg = e.msg; tid = e.tid; theError = *this; }

      virtual ~RulbusError() { ; }


      virtual  CharCptr      what   () const { return to_cstr( msg ); }

      virtual  unsigned long lasttid() const { return tid;         }

      static   bool     getLastError( char *msg, int maxlen );


   private:
      String msg;                       
      unsigned long tid;                

      static RulbusError theError;      
   };

   class RulbusScanError : public RulbusError
   {
   public:
      RulbusScanError( StringCref msg ):
         RulbusError( msg ) { ; }
   };

   class RulbusParseError : public RulbusError
   {
   public:
      RulbusParseError( StringCref msg ):
         RulbusError( msg ) { ; }
   };

   class RulbusConfigError : public RulbusError
   {
   public:
      RulbusConfigError( StringCref msg ):
         RulbusError( to_cstr( msg ) ) { ; }
   };

   class RulbusInterfaceError : public RulbusError
   {
   public:
      RulbusInterfaceError( StringCref msg ):
         RulbusError( to_cstr( msg )  ) { ; }
   };

   class RulbusOpenError : public RulbusError
   {
   public:
      RulbusOpenError( StringCref submsg ):
         RulbusError( "cannot open rulbus device: %s", to_cstr( submsg ) ) { ; }

      RulbusOpenError( StringCref name, int rack, int addr ):
         RulbusError( "cannot open rulbus device '%s' at [%d:0x%02X]", to_cstr( name ), rack, addr ) { ; }
   };

   class RulbusCloseError : public RulbusError
   {
   public:
      RulbusCloseError( int handle ):
         RulbusError("cannot close rulbus device with handle '%d'", handle ) { ; }
   };

   class RulbusHandleError : public RulbusError
   {
   public:
      RulbusHandleError( int handle ):
         RulbusError("invalid handle '%d'", handle ) { ; }
   };

   class RulbusAddressError : public RulbusError
   {
   public:
      RulbusAddressError( StringCref name, int rack, int addr ):
         RulbusError("address violation, device '%s', address [%d:0x%02X]", to_cstr( name ), rack, addr ) { ; }
   };

   class RulbusDataError : public RulbusError
   {
   public:
      RulbusDataError( StringCref name, int rack, int addr, int data ):
         RulbusError("data violation, device '%s', address [%d:0x%02X], data [0x%02X]", to_cstr( name ), rack, addr, data ) { ; }
   };

   class RulbusRangeError : public RulbusError
   {
   public:
      RulbusRangeError( ):
         RulbusError() { ; }

      RulbusRangeError( StringCref name, StringCref parameter, int data, int min, int max ):
         RulbusError("device '%s', range error: %s %d not in [%d..%d]", to_cstr( name ), to_cstr( parameter ), data, min, max ) { ; }

      RulbusRangeError( StringCref name, StringCref parameter, long data, long min, long max ):
         RulbusError("device '%s', range error: %s %ld not in [%ld..%ld]", to_cstr( name ), to_cstr( parameter ), data, min, max ) { ; }

      RulbusRangeError( StringCref name, StringCref parameter, Real data, Real min, Real max ):
         RulbusError("device '%s', range error: %s %g not in [%g..%g]", to_cstr( name ), to_cstr( parameter ), data, min, max ) { ; }

      RulbusRangeError( StringCref name, StringCref parameter, StringCref data, StringCref set ):
         RulbusError("device '%s', range error: %s %s not in [%s]", to_cstr( name ), to_cstr( parameter ), to_cstr( data ), to_cstr( set ) ) { ; }
   };

   class RulbusContextError : public RulbusError
   {
   public:
      RulbusContextError( StringCref name, StringCref msg ):
         RulbusError("device '%s', context error: %s", to_cstr( name ), to_cstr( msg ) ) { ; }
   };

   class RulbusTimeoutError : public RulbusError
   {
   public:
      RulbusTimeoutError( ):
         RulbusError() { ; }

      RulbusTimeoutError( StringCref name, StringCref msg ):
         RulbusError("device '%s', timeout: %s", to_cstr( name ), to_cstr( msg ) ) { ; }
   };

}       // namespace Rulbus

#endif  // __EXCEPTION_H

/*
 * end of file
 */

---