Class for doing some arbitrary parcel of work in its own thread. More...

Inheritance diagram for swift::misc::CWorker:

Public Member Functions
template<typename R , typename F >
void	thenWithResult (F functor)
	Connects to a functor to which will be passed the result when the task is finished. More...

template<typename R , typename T , typename F >
void	thenWithResult (T *context, F functor)
	Connects to a functor or method to which will be passed the result when the task is finished. More...

template<typename R >
R	result ()
	Returns the result of the task, waiting for it to finish if necessary. More...

Public Member Functions inherited from swift::misc::CWorkerBase
	~CWorkerBase ()
	Destructor.

	CWorkerBase (const CWorkerBase &)=delete
	Copy constructor.

CWorkerBase &	operator= (const CWorkerBase &)=delete
	Copy assignment.

	CWorkerBase (CWorkerBase &&)=delete
	Move constructor.

CWorkerBase &	operator= (CWorkerBase &&)=delete
	Move assignment.

template<typename T , typename F >
void	then (T *context, F functor)
	Connects to a functor or method which will be called when the task is finished. More...

template<typename F >
void	then (F functor)
	Connects to a functor which will be called when the task is finished. More...

bool	isFinished () const
	Returns true if the task has finished. More...

template<typename F >
void	doIfFinished (F functor) const
	Executes some code (in the caller's thread) if the task has finished. More...

template<typename F >
void	doIfNotFinished (F functor) const
	Executes some code (in the caller's thread) if the task has not finished. More...

template<typename F1 , typename F2 >
void	doIfFinishedElse (F1 ifFunctor, F2 elseFunctor) const
	Executes some code (in the caller's thread) if the task has finished and some different code if it has not finished. More...

void	waitForFinished () noexcept
	Blocks until the task is finished. More...

void	abandon () noexcept
	Notify the task that its result is no longer needed, so it can finish early. More...

void	abandonAndWait () noexcept
	Convenience to call abandon() followed by waitForFinished().

Public Member Functions inherited from QObject
QBindable< QString >	bindableObjectName ()

	QObject (QObject *parent)

	QT_NO_CONTEXTLESS_CONNECT QT_NO_CONTEXTLESS_CONNECT

	QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT

	Q_CLASSINFO (Name, Value)

	Q_EMIT Q_EMIT

	Q_ENUM (...)

	Q_ENUMS (...)

	Q_ENUM_NS (...)

	Q_FLAG (...)

	Q_FLAGS (...)

	Q_FLAG_NS (...)

	Q_GADGET Q_GADGET

	Q_GADGET_EXPORT (EXPORT_MACRO)

	Q_INTERFACES (...)

	Q_INVOKABLE Q_INVOKABLE

	Q_MOC_INCLUDE Q_MOC_INCLUDE

	Q_NAMESPACE Q_NAMESPACE

	Q_NAMESPACE_EXPORT (EXPORT_MACRO)

	Q_OBJECT Q_OBJECT

	Q_PROPERTY (...)

	Q_REVISION Q_REVISION

	Q_SET_OBJECT_NAME (Object)

	Q_SIGNAL Q_SIGNAL

	Q_SIGNALS Q_SIGNALS

	Q_SLOT Q_SLOT

	Q_SLOTS Q_SLOTS

T	qobject_cast (QObject *object)

T	qobject_cast (const QObject *object)

bool	blockSignals (bool block)

virtual bool	event (QEvent *e)

virtual bool	eventFilter (QObject watched, QEvent event)

bool	moveToThread (QThread *targetThread)

bool	setProperty (const char *name, QVariant &&value)

bool	setProperty (const char *name, const QVariant &value)

int	startTimer (int interval, Qt::TimerType timerType)

int	startTimer (std::chrono::nanoseconds interval, Qt::TimerType timerType)

void	deleteLater ()

void	destroyed (QObject *obj)

void	installEventFilter (QObject *filterObj)

void	killTimer (Qt::TimerId id)

void	killTimer (int id)

void	objectNameChanged (const QString &objectName)

void	removeEventFilter (QObject *obj)

void	setObjectName (QAnyStringView name)

void	setObjectName (const QString &name)

void	setParent (QObject *parent)

QList< QByteArray >	dynamicPropertyNames () const const

QList< T >	findChildren (QAnyStringView name, Qt::FindChildOptions options) const const

QList< T >	findChildren (Qt::FindChildOptions options) const const

QList< T >	findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const

QMetaObject::Connection	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const const

QObject *	parent () const const

QString	objectName () const const

QThread *	thread () const const

QVariant	property (const char *name) const const

T	findChild (QAnyStringView name, Qt::FindChildOptions options) const const

T	findChild (Qt::FindChildOptions options) const const

bool	disconnect (const QObject receiver, const char method) const const

bool	disconnect (const char signal, const QObject receiver, const char *method) const const

bool	inherits (const char *className) const const

bool	isQuickItemType () const const

bool	isWidgetType () const const

bool	isWindowType () const const

bool	signalsBlocked () const const

virtual const QMetaObject *	metaObject () const const

const QObjectList &	children () const const

void	dumpObjectInfo () const const

void	dumpObjectTree () const const

Static Public Member Functions
template<typename F >
static CWorker *	fromTask (QObject *owner, const QString &name, F &&task)
	Returns a new worker object which lives in a new thread. More...

Static Public Member Functions inherited from swift::misc::CWorkerBase
static const QStringList &	getLogCategories ()
	Log categories.

static const QSet< CWorkerBase * > &	allWorkers ()
	All workers currently existing.

Static Public Member Functions inherited from QObject
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject context, Functor functor, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject receiver, PointerToMemberFunction method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

QString	tr (const char sourceText, const char disambiguation, int n)

bool	disconnect (const QMetaObject::Connection &connection)

bool	disconnect (const QObject sender, PointerToMemberFunction signal, const QObject receiver, PointerToMemberFunction method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

Additional Inherited Members
Signals inherited from swift::misc::CWorkerBase
void	aboutToStart ()
	Emitted when the task is about to start.

void	finished ()
	Emitted when the task is finished. More...

Public Attributes inherited from QObject
typedef	QObjectList

Protected Member Functions inherited from swift::misc::CWorkerBase
	CWorkerBase ()
	Constructor.

bool	isAbandoned () const
	For the task to check whether it can finish early. More...

bool	hasStarted () const
	True if the worker has started.

void	setStarted ()
	Mark the task as started.

void	setFinished ()
	Mark the task as finished.

Protected Member Functions inherited from QObject
virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const QMetaMethod &signal)

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const QMetaMethod &signal)

virtual void	timerEvent (QTimerEvent *event)

QObject *	sender () const const

bool	isSignalConnected (const QMetaMethod &signal) const const

int	receivers (const char *signal) const const

int	senderSignalIndex () const const

Properties inherited from QObject
	objectName

Detailed Description

Class for doing some arbitrary parcel of work in its own thread.

The task is exposed as a function object, so could be a lambda or a hand-written closure. CWorker can not be subclassed, instead it can be extended with rich callable task objects.

Definition at line 211 of file worker.h.

Member Function Documentation

◆ fromTask()

template<typename F >

static CWorker* swift::misc::CWorker::fromTask	(	QObject *	owner,
		const QString &	name,
		F &&	task
	)

inlinestatic

Returns a new worker object which lives in a new thread.

Note: The worker calls its own deleteLater method when finished. Typically assign it to a QPointer if you want to store it.

Parameters

owner	Will be the parent of the new thread (the worker has no parent).
name	A name for the task, which will be used to create a name for the thread.
task	A function object which will be run by the worker in its thread.

Definition at line 225 of file worker.h.

◆ result()

template<typename R >

R swift::misc::CWorker::result ( )

inline

Returns the result of the task, waiting for it to finish if necessary.

Template Parameters

R	The return type of the task.

Remarks: This function is thread safe.

Definition at line 269 of file worker.h.

◆ thenWithResult() [1/2]

template<typename R , typename F >

void swift::misc::CWorker::thenWithResult ( F functor )

inline

Connects to a functor to which will be passed the result when the task is finished.

Template Parameters

R	The return type of the task.

Remarks: This function is thread safe. The functor may not call any method that observes the worker's finished flag.

Definition at line 242 of file worker.h.

◆ thenWithResult() [2/2]

template<typename R , typename T , typename F >

void swift::misc::CWorker::thenWithResult	(	T *	context,
		F	functor
	)

inline

Connects to a functor or method to which will be passed the result when the task is finished.

Template Parameters

R	The return type of the task.

Remarks: This function is thread safe. The functor may not call any method that observes the worker's finished flag.

Definition at line 252 of file worker.h.

The documentation for this class was generated from the following files:

src/misc/worker.h
src/misc/worker.cpp

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ fromTask()

◆ result()

◆ thenWithResult() [1/2]

◆ thenWithResult() [2/2]