CopperSpice API  1.9.1
QtConcurrent::Exception Class Reference

The QtConcurrent::Exception class provides a base class for exceptions that can transferred across threads. More...

Inheritance diagram for QtConcurrent::Exception:
QtConcurrent::UnhandledException

Public Methods

virtual Exception * clone () const
 
virtual void raise () const
 

Detailed Description

The QtConcurrent::Exception class provides a base class for exceptions that can transferred across threads. This class supports throwing and catching exceptions across thread boundaries, provided the exception inherits from QtConcurrent::Exception and implements two methods.

class MyException : public QtConcurrent::Exception
{
public:
void raise() const { throw *this; }
Exception *clone() const { return new MyException(*this); }
};

QtConcurrent::Exception subclasses must be thrown by value and caught by reference:

try {
QtConcurrent::blockingMap(list, throwFunction); // throwFunction throws MyException
} catch (MyException &e) {
// handle exception
}

If you throw an exception that is not a subclass of QtConcurrent::Exception, the QtConcurrent functions will throw a QtConcurrent::UnhandledException in the receiver thread.

When using QFuture, transferred exceptions will be thrown when calling the following methods.

Method Documentation

Exception * QtConcurrent::Exception::clone ( ) const
virtual

When inheriting from QtConcurrent::Exception you must reimplement clone().

MyException *MyException::clone() const {
return new MyException(*this);
}

Reimplemented in QtConcurrent::UnhandledException::clone()

void QtConcurrent::Exception::raise ( ) const
virtual

When inheriting from QtConcurrent::Exception you must reimplement raise().

void MyException::raise() const {
throw *this;
}

Reimplemented in QtConcurrent::UnhandledException::raise()