rwsf::Exception

• Local Index
• Header File
• Description
• Public Constructors
• Destructor
• Public Member Function
• Public Operator
• Macros

Members

clone() Exception() operator=()

raise() RWSF_DECLARE_EXCEPTION_METHODS() RWSF_DEFINE_EXCEPTION_METHODS()

what() why() ~Exception()

#include <rwsf/core/except.h>

rwsf::Exception is the base class for all exceptions.

Following is the hierarchy of the exception classes. All exception classes are declared in rwsf/core/except.h.

Figure 1: Exception Hierarchy

rwsf::Exception
  rwsf::AllocException
  rwsf::ExternalException
  rwsf::InternalException
     rwsf::OutofBoundsException
     rwsf::RegexException
  rwsf::ThreadException
  rwsf::NamingException
  rwsf::XmlException
    rwsf::XmlParseException
    rwsf::XmlSchemaException

Exception(const char* msg);

Creates an exception that returns msg when its method why() is called.

Exception(const Exception&);

Copy constructor.

virtual 
~Exception();

Destructor.

virtual void 
raise ( void ) const; 

Virtual. Throws self. Overridden in derived class to throw correct derived type.

virtual Exception* 
clone ( void ) const;

Virtual. Creates a new copy of self on the heap. Overridden in derived classes to construct an instance of the correct derived type.

virtual const char* 
why() const;

DEPRECATED. Please use the stl what() form.

virtual const char* 
what() const;

Returns the message string contained in self.

Exception& 
operator= (const Exception& m);

Assignment operator. Makes self a deep copy of m.

---

NOTE -- Derived classes must define the following two macros (or the methods they represent) in order to ensure that an exception is thrown correctly from a thread.

---

#define RWSF_DECLARE_EXCEPTION_METHODS(className)

This macro declares the appropriate raise and clone methods required of an exception that can be handled from within a thread.

#define RWSF_DEFINE_EXCEPTION_METHODS(className)

This macro defines the appropriate raise and clone methods required of an exception that can be handled from within a thread.

©2004-2007 Copyright Quovadx, Inc. All Rights Reserved.
Quovadx and Rogue Wave are registered trademarks and HydraSDO is a trademark 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.