Exception Classes

Thread-compatible exception class  RWTHRxmsg
or
Thread-compatible exception class  RWTHRIllegalUsage  RWTHRxmsg

• Data Type and Member Function Indexes
• Package
• ITC
  Header File
• Thread -compatible Exceptions Header Files
• Description
• Public Constructor
• Public Member Functions
• See Also

Member Functions

clone()

raise()

Interthread Communication, Thread-compatible Exceptions

#include <rw/itc/RWTHRClosedException.h> 

#include <rw/threxcept/RWTHRExternalError.h> 
#include <rw/threxcept/RWTHRIllegalUsage.h> 
#include <rw/threxcept/RWTHRInternalError.h> 
#include <rw/threxcept/RWTHROperationAborted.h> 
#include <rw/threxcept/RWTHROperationCanceled.h> 
#include <rw/threxcept/RWTHROperationNotAvailable.h> 
#include <rw/threxcept/RWTHROperationNotImplemented.h> 
#include <rw/threxcept/RWTHROperationTerminated.h> 
#include <rw/threxcept/RWTHRPermissionError.h> 
#include <rw/threxcept/RWTHRResourceLimit.h> 
#include <rw/threxcept/RWTHRBoundsError.h> 
#include <rw/threxcept/RWTHRIllegalAccess.h> 
#include <rw/threxcept/RWTHRInvalidPointer.h> 
#include <rw/threxcept/RWTHROperationNotSupported.h> 
#include <rw/threxcept/RWTHRThreadActive.h> 
#include <rw/threxcept/RWTHRThreadNotActive.h> 
#include <rw/threxcept/RWTHRxmsg.h> 

The classes listed below are thread-compatible exception classes. A thread compatible exception possesses clone() and raise() members that allow the exception to be copied and stored so that it may be rethrown in the future. This capability allows these exceptions to be passed across thread boundaries. The following classes inherit directly from RWTHRxmsg.

RWTHRClosedException

RWTHRExternalError

RWTHRIllegalUsage

RWTHRInternalError

RWTHROperationAborted

RWTHROperationCanceled

RWTHROperationNotAvailable

RWTHROperationNotImplemented

RWTHROperationTerminated

RWTHRPermissionError

RWTHRResourceLimit

Note that RWTHRCompatibleException<Exception> also inherits from RWTHRxmsg, but is listed elsewhere because it offers additional functionality.

The following classes inherit from RWTHRIllegalUsage:

RWTHRBoundsError

RWTHRIllegalAccess

RWTHRInvalidPointer

RWTHROperationNotSupported

RWTHRThreadActive

RWTHRThreadNotActive

All of these classes have the same interface. In the following sections, we will use RWTHRException to stand in for the listed class names.

RWTHRException(const RWCString 
&msg="<Appropriate Description>");

Constructs the exception class.

virtual void
raise(void) const;

Throws an exception of the runtime type of self.

virtual RWTHRException*
clone(void) const;

Calls the copy constructor of the runtime type of self and returns the result.

RWTHRxmsg, RWTHRCompatibleException<Exception>, Section 2.4, "Interthread Communication Package," and Section 2.7, "Thread-compatible Exceptions Package."

©Copyright 2000, Rogue Wave Software, Inc.
Contact Rogue Wave about documentation or support issues.