Struct qt_core::QException

#[repr(C)]
pub struct QException { /* private fields */ }

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

C++ class: QException.

C++ documentation:

Qt Concurrent supports throwing and catching exceptions across thread boundaries, provided that the exception inherit from QException and implement 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 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()

Implementations

impl QException

pub unsafe fn clone(&self) -> Ptr<QException>

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

Calls C++ function: virtual QException* QException::clone() const.

C++ documentation:

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

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

pub unsafe fn copy_from( &self, other: impl CastInto<Ref<QException>> ) -> Ref<QException>

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

Calls C++ function: QException& QException::operator=(const QException& other).

C++ documentation:

Qt Concurrent supports throwing and catching exceptions across thread boundaries, provided that the exception inherit from QException and implement 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 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()

pub unsafe fn new() -> CppBox<QException>

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

Calls C++ function: [constructor] void QException::QException().

C++ documentation:

Qt Concurrent supports throwing and catching exceptions across thread boundaries, provided that the exception inherit from QException and implement 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 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()

pub unsafe fn new_copy( other: impl CastInto<Ref<QException>> ) -> CppBox<QException>

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

Calls C++ function: [constructor] void QException::QException(const QException& other).

C++ documentation:

Qt Concurrent supports throwing and catching exceptions across thread boundaries, provided that the exception inherit from QException and implement 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 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()

pub unsafe fn raise(&self)

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

Calls C++ function: virtual void QException::raise() const.

C++ documentation:

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

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

Trait Implementations

impl CppDeletable for QException

unsafe fn delete(&self)

Destroys the instance of QException. The destructor is virtual.

Calls C++ function: virtual [destructor] void QException::~QException().

C++ documentation:

Destroys the instance of QException. The destructor is virtual.

impl DynamicCast<QUnhandledException> for QException

unsafe fn dynamic_cast(ptr: Ptr<QException>) -> Ptr<QUnhandledException>

Calls C++ function: QUnhandledException* dynamic_cast<QUnhandledException*>(QException* ptr).

impl StaticDowncast<QUnhandledException> for QException

unsafe fn static_downcast(ptr: Ptr<QException>) -> Ptr<QUnhandledException>

Calls C++ function: QUnhandledException* static_cast<QUnhandledException*>(QException* ptr).

impl StaticUpcast<QException> for QUnhandledException

unsafe fn static_upcast(ptr: Ptr<QUnhandledException>) -> Ptr<QException>

Calls C++ function: QException* static_cast<QException*>(QUnhandledException* ptr).