exception

Module:  Standard C++ Library   Library:  Language support

Does not inherit

• Local Index
• Summary
• Synopsis
• Interface
• Example
• Constructors
• Destructor
• Public Member Operator
• Public Member Function
• See Also
• Standards Conformance

Members

exception()

operator=()

what()

~exception()

Class exception is the base class that supports logic and runtime errors.

#include <exception>

namespace std {
  class exception;
}

namespace std {
      class exception {
      public:
        exception() throw();
        exception(const exception&) throw();
        exception& operator=(const exception&) throw();
        virtual ~exception() throw();
        virtual const char* what() const throw();
      };
}

//
// except.cpp
//

#include <iostream>
#include <stdexcept>


#ifndef _RWSTD_NO_EXCEPTIONS

int main ()
{
   try {
       // Enable exceptions in cin.
       std::cin.exceptions(std::ios::eofbit);

       // Clear all bits and set eofbit.
       std::cin.clear(std::ios::eofbit);
   }
   catch (const std::ios::failure &e) {
       std::cout << "Caught an exception: " 
                 << e.what () << std::endl;
   }
   catch (const std::exception &e) {
       std::cout << "Caught an exception: " 
                 << e.what () << std::endl;

       return 1;   // Indicate failure.
   }
   catch (...) {
       std::cout << "Caught an unknown exception" 
                 << std::endl;

       return 1;   // Indicate failure.
   }

   return 0;
}

#else

int main ()
{
    std::cout << "Exceptions not supported." << std::endl;

    return 0;
}


#endif   // _RWSTD_NO_EXCEPTIONS

Program Output:

Caught an exception: std::cin: stream object has set ios::eofbit

exception() throw();

Default constructor. Constructs an object of class exception.

exception(const exception&) throw();

Copy constructor. Copies an exception object.

virtual ~exception() throw();

Destructor. Destroys an object of class exception.

exception& 
operator=(const exception&) throw();

Assignment operator. Copies an exception object.

virtual const char* 
what() const throw();

Returns an implementation-defined, null-terminated byte string representing a human-readable message describing the exception. The message may be a null-terminated multibyte string, suitable for conversion and display as a wstring.

Exceptions, bad_alloca, bad_cast, bad_exception, bad_typeid, domain_error, invalid_argument, ios_base::failure, length_error, logic_error, out_of_range, overflow_error, range_error, runtime_error, underflow_error

ISO/IEC 14882:1998 -- International Standard for Information Systems --Programming Language C++, Section 19.1

©2004 Copyright Quovadx, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Quovadx, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.