FX::FXThread Class Reference

FXThread provides system-independent support for threads. More...

#include <FXThread.h>

List of all members.

Public Member Functions
	FXThread ()
FXThreadID	id () const
FXbool	running () const
FXbool	start (unsigned long stacksize=0)
FXbool	join ()
FXbool	join (FXint &code)
FXbool	cancel ()
FXbool	detach ()
void	priority (FXint prio)
FXint	priority ()
virtual	~FXThread ()
Static Public Member Functions
void	exit (FXint code=0)
void	yield ()
void	sleep (unsigned long sec, unsigned long nsec=0)
FXThread *	self ()
FXThreadID	current ()

---

Detailed Description

FXThread provides system-independent support for threads.

Subclasses must implement the run() function do implement the desired functionality of the thread. The storage of the FXThread object is to be managed by the calling thread, not by the thread itself.

---

Constructor & Destructor Documentation

FX::FXThread::FXThread (   )

Initialize thread object.

virtual FX::FXThread::~FXThread (   )  [virtual]

Destroy the thread immediately, running or not. It is probably better to wait until it is finished, in case the thread currently holds mutexes.

---

Member Function Documentation

FXThreadID FX::FXThread::id (   )  const

Return handle of this thread object. This handle is valid in the context of the thread which called start().

FXbool FX::FXThread::running (   )  const

Return TRUE if this thread is running.

FXbool FX::FXThread::start (  unsigned long  stacksize = 0  )

Start thread; the thread is started as attached. The thread is given stacksize for its stack; a value of zero for stacksize will give it the default stack size.

FXbool FX::FXThread::join (   )

Suspend calling thread until thread is done.

FXbool FX::FXThread::join (  FXint &  code  )

Suspend calling thread until thread is done, and set code to the return value of run() or the argument passed into exit(). If an exception happened in the thread, return -1.

FXbool FX::FXThread::cancel (   )

Cancel the thread, stopping it immediately, running or not. If the calling thread is this thread, nothing happens. It is probably better to wait until it is finished, in case the thread currently holds mutexes.

FXbool FX::FXThread::detach (   )

Detach thread, so that a no join() is necessary to harvest the resources of this thread.

void FX::FXThread::exit (  FXint  code = 0  )  [static]

Exit the calling thread. No destructors are invoked for objects on thread's stack; to invoke destructors, throw an exception instead.

void FX::FXThread::yield (   )  [static]

Make the thread yield its time quantum.

void FX::FXThread::sleep (  unsigned long  sec, unsigned long  nsec = 0 )  [static]

Make the calling thread sleep for a number of seconds and nanoseconds.

FXThread* FX::FXThread::self (   )  [static]

Return pointer to the FXThread instance associated with the calling thread; it returns NULL for the main thread and all threads not created by FOX.

FXThreadID FX::FXThread::current (   )  [static]

Return thread id of calling thread.

void FX::FXThread::priority (  FXint  prio  )

Set thread priority.

FXint FX::FXThread::priority (   )

Return thread priority.

Copyright © 1997-2005 Jeroen van der Zijp