SystemException.h

Go to the documentation of this file.

#ifndef CARMA_UTIL_SYSTEM_EXCEPTION_H
#define CARMA_UTIL_SYSTEM_EXCEPTION_H

#include <string>

// show be including <iosfwd> but the API passes std::ostringstream's by value
#include <sstream>

#include <cerrno>

#include "carma/util/BaseException.h"


namespace carma  {
namespace util  {


class SystemException : public BaseException  {
    public:
        SystemException( const SystemException & rhs );

        SystemException( const char * mesg,
                         const char * sysMesg = strerror( errno ),
                         const char * fileName = __FILE__, 
                         const int    lineNum = __LINE__ );

        SystemException( std::ostringstream & message,
                         const char *         sysMessage = strerror( errno ),
                         const char *         fileName = __FILE__,
                         const int            lineNum = __LINE__ );

        SystemException( std::ostringstream &     message,
                         const std::ostringstream sysMessage = std::ostringstream( strerror( errno ) ),
                         const char *             fileName = __FILE__,
                         const int                lineNum = __LINE__ );

        SystemException( std::string &     istring,
                         const std::string sysMessage = strerror( errno ),
                         const char *      fileName = __FILE__,
                         const int         lineNum = __LINE__ );

        virtual ~SystemException( ) throw( );

        SystemException & operator=( const SystemException & rhs );

        virtual const char * getSysMessage( ) const;

        virtual ::std::string getLogString( ) const;
        
    protected:
        explicit SystemException( );

    private:
        void clearSysMesg( );
        
        void setSysMesg( const ::std::string & sysMesg );

        const char * sysMesg_;
        bool         weAllocatedSysMesg_;
};  // class SystemException


}  // namespace carma::util
}  // namespace carma


#define CARMA_SYSTEM_EXCEPTION(msg) carma::util::SystemException((msg), strerror(errno), __FILE__, __LINE__)


#endif    // CARMA_UTIL_SYSTEM_EXCEPTION_H