QException Class | Qt Core | Qt 6.10.1
Description: The QException class provides a base class for exceptions that can be transferred across threads.

- Qt 6.10
- Qt Core
- C++ Classes
- QException
- Qt 6.10.1 Reference Documentation

# QException Class

The QException class provides a base class for exceptions that can be transferred across threads. More...

Header: | `#include <QException>`
CMake: | `find_package(Qt6 REQUIRED COMPONENTS Core)` `target_link_libraries(mytarget PRIVATE Qt6::Core)`
qmake: | `QT += core`
Inherited By: | QUnhandledException

- List of all members, including inherited members

## Public Functions

| QException()
| QException(const QException &other)
virtual | ~QException()
virtual QException * | clone() const
virtual void | raise() const
QException & | operator=(const QException &other)

## Detailed Description

Qt Concurrent supports throwing and catching exceptions across thread boundaries, provided that the exception inherits from QException and implements two helper functions:

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

QException 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 QException, the Qt Concurrent functions will throw a QUnhandledException in the receiver thread.

When using QFuture, transferred exceptions will be thrown when calling the following functions:

- QFuture::waitForFinished()
- QFuture::result()
- QFuture::resultAt()
- QFuture::results()

## Member Function Documentation

### `[noexcept]` QException::QException()

Constructs a QException object.

### `[constexpr noexcept]` QException::QException(const QException &other)

Creates a copy of other.

Note: Be careful when using this function, as you risk slicing.

See also clone().

### `[virtual noexcept]` QException::~QException()

Destroys this QException object.

### `[virtual]` QException *QException::clone() const

In your QException subclass, reimplement clone() like this:

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

### `[virtual]` void QException::raise() const

In your QException subclass, reimplement raise() like this:

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

### `[noexcept]` QException &QException::operator=(const QException &other)

Copy-assigns other over this object.

Note: Be careful when using this function, as you risk slicing.